CHcheckout
Standalone Account Updater

Get updated card credentials

Retrieve updated card credentials. <p/> The following card schemes are supported:

  • Mastercard
  • Visa
  • American Express
post/account-updater/cards

Request

Request body

Example request

{
  "source_options": {
    "card": {
      "number": "5436424242424242",
      "expiry_month": 5,
      "expiry_year": 2025
    },
    "instrument": {
      "id": "src_nmukohhu7vbe5f55ndwqzwv2c4"
    }
  }
}

Response

Request was successful, updated card info is available in the response

account_update_status'CARD_UPDATED' | 'CARD_EXPIRY_UPDATED' | 'CARD_CLOSED' | 'UPDATE_FAILED' required

Result of the update operation.

account_update_failure_code'CARDHOLDER_OPT_OUT' | 'UP_TO_DATE' | 'NON_PARTICIPATING_BIN' | 'UNKNOWN'

This field is returned when the update fails and the scheme returns an appropriate reason code. <p/>

For more information, see Standalone Account Updater

Example response

{
  "account_update_status": "CARD_UPDATED",
  "card": {
    "encrypted_card_number": "3nCryp73dFPANv4lu3",
    "bin": "543642",
    "last4": "4242",
    "expiry_month": 5,
    "expiry_year": 2025,
    "fingerprint": "abc123fingerprint"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.