UPDATE BILLING

Overview

There may be a time where you need to update one of your customers payment details to process subsequent REBILLs'. For example, you may have received a message from a customer to say they have updated their expiration date.

To allow for subsequent transactions against this customer to be processed, you would need to update the existing INIT for future use otherwise the token we have on file won't have the most up to date information and the transaction will be declined.

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

Please see below sample code of an UPDATE_BILLING request.


{
    "timestamp":"20170612200234",
    "company_id":"133",
    "company_pass":"password ",
    "company_mid_id":"",
    "request_hash":"f0a18260b08a0bfacb...",
    "transaction":{
        "merchant_order_id":"20170612200234",
        "transaction_type":"AUTH_CAPTURE",
        "original_transaction_id":"1234567",
        "subscription_type":"UPDATE_BILLING",
        "amount":"100",
        "currency_code_iso3":"GBP"
        } ,
    "billing":{
        "cardholder_name":"MR E N JOHNSON",
        "cardnumber":"4024007164218280",
        "card_type":"VISA",
        "cardcvv":"456",
        "cardexp":"032022"
        } ,
    }
  

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: UPDATE_BILLING.
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.
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.