External Keys

ChargeOver has an external keys concept for all objects, to make it easier for you to integrate external systems with ChargeOver.

All objects (customers, users, invoices, billing packages, etc.) can be assigned a user-definable, unique external key value. This could be an internal identifier you use to identify a customer, the ID value from some other application, a reference to a primary key within one of your other systems, etc. When making API requests, you can always use the external key value instead of the ChargeOver id value.

External key policies:

Default behavior - external key values can NOT be re-used, even if the original object is deleted or cancelled
Optional - external key values can be cleared (and thus re-used) once a subscription is cancelled
Optional - external key values can be cleared (and thus re-used) if an object is deleted
Optional - external key values can be mangled (a random string will be added to the end of them) if a subscription is cancelled
Optional - external key values can be mangled (a random string added to the end of them) if an object is deleted