Sign in

v1

latestOpenAPI 3.0.02026-07-2431146358.7 KB
Card Account

List Card Account

This API will fetch the list of cardaccounts created for a customer_refid.

post/tokenizer/ve1_2/token/list

Headers

BD-Traceidstring required
Example:20201203182838

BD-TraceID is a unique identifier passed by the merchant to ensure request idempotency. Requests with identical BD-TraceID within a 24 hour window would fail.

BD-Timestampstring required
Example:20201203182838

Request timestamp to identify date and time of origin of request. Example, a value of BD-Timestamp 20210113180403 identifies the request to have originated on 13th January 2021 at 06:04:03 PM.

Content-Typestring required
Example:application/json

Request Content-Type to take the values application/jose

Acceptstring required
Example:application/jose

Accept Response Content-Type to take the values application/jose

Request body

mercidstring required

Unique identifier as defined by BillDesk for each merchant

customer_refidstring required

Unique reference of the customer in the merchant system, and can be linked to different subscriptions of the same customer Required for mandate and tokenization

Example request

{
  "mercid": "BDMERCID",
  "customer_refid": "CSREF00001"
}

Response

OK

mercidstring

Unique identifier as defined by BillDesk for each merchant

customer_refidstring

Unique reference of the customer in the merchant system, and can be linked to different subscriptions of the same customer Required for mandate and tokenization

Example response

{
  "mercid": "BDMERCID",
  "customer_refid": "CSREF00001",
  "cards": [
    {
      "cardaccountid": "CA0AAEF9000000000123",
      "orderid": "TEST0000009005",
      "masked_value": "xxxxxxxxxxxx1001",
      "network": "VISA, MASTER",
      "network_token": {
        "token_ref_no": "0f276cf3-a251-4f49-9567-da12ba9e028a",
        "status": "ACTIVE"
      }
    }
  ]
}