Manage Cards

Overview

TThere may be a time where you need to update one of your customer's 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, and update your token references. In fact, we allow you to update any parameter you wish to, except for 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 a SUBSCRIPTION_MANAGE transaction. Simply populate the subscription_type parameter with SUBSCRIPTION_MANAGE of the authorisation request.

Please see below sample code of a SUBSCRIPTION_MANAGE request.

{
"timestamp":"20201124154420",
"company_id":113,
"company_pass":"password",
"company_mid_id":1045,
"request_hash" : "f0a18260b08a0bfacb.....",
"transaction":{
    "merchant_order_id":"a9f0ce93-6f0d-4a15-a18b-45f1304b4bc0",
    "transaction_type":"SUBSCRIPTION_MANAGE",
    "subscription_type":"UPDATE_BILLING",
    "original_transaction_id": "123456"
    },
"billing" : {
    "billing_street":"Suite 2, 4th Floor",
    "billing_street2":"44 Baker Street",
    "billing_city":"London",
    "billing_zipcode":"W1U7AL",
    "billing_phone":"+44(0)2039826580",
    "billing_email":"support@acquired.com"
    }
}

Request Parameters

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