Manage Cards


Time to play - access your API using these endpoints:


There may be a time where you need to update one of your customers personal details to process subsequent REBILLs'. For example, your customers may move house and as such, you need to ensure that you have the latest information on record.

If this happens, you will need to be able to update the token reference - otherwise known as the INIT transaction.

This is where the SUBSCRIPTION_MANAGE comes in. We allow you to update your customers personal details i.e. billing, shipping, customer data and 6012 data for example and update your token references. In fact, we allow you to update any parameter you wish to except the cardnumber and the exp_date. If you want these details updated, please process an UPDATE_BILLING request. For more information, please see here.

We will then go and update your INIT - the token reference - to allow for subsequent REBILLS to be processed.

To complete this, you will need to process an SUBSCRIPTION_MANAGE transaction. Simply populate the subscription_type parameter with SUBSCRIPTION_MANAGE of the authorisation request.

Please see below sample code of an SUBSCRIPTION_MANAGE request.

"request_hash" : "f0a18260b08a0bfacb.....",
"customer" : {
"billing" : {
    "billing_street":"Suite 2, 4th Floor",
    "billing_street2":"44 Baker Street",
"shipping" : {
    "shipping_street":"Suite 2, 4th Floor",
    "shipping_street2":"44 Baker Street",

Request Parameters

The table below details the parameters that must be submitted in order to update your token reference - the INIT.

Parameter Format Length Description
subscription_type string 4 - 14 Set value to: SUBSCRIPTION_MANAGE.
This instructs us to update the already stored card and customer data associated with a token reference if the transaction is successfully authorised with the cardholders issuing bank.
Acceptable Characters: a-Z A-Z _
Hey - Does doing this automatically sound good to you - ensuring that all your tokens with us are all up to date with the latest information. Send a message to the Support Team and learn all about our Account Updater solution.