Retrieve Card Account

post

https://uat1.billdesk.com/u2/tokenizer/ve1_2/token/retrieve

Retrieve details of a cardaccount either by using the mercid and cardaccountid or the mercid, orderid and customer_refid as inputs.

Body Params

mercid

string

required

^[A-Za-z0-9]{1,10}$

Unique identifier as defined by BillDesk for each merchant

cardaccountid

string

^[A-Za-z0-9]{1,35}$

Unique ID created by BillDesk for the combination of card number, mercid and customer_refid

customer_refid

string

^[A-Za-z0-9\\_\\:\\-]{1,80}$

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

orderid

string

^[-/~A-Za-z0-9\_ \:.,#@!\\*\\+]{1,120}$

Unique ID generated by the merchant for each request

Headers

BD-Traceid

string

required

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-Timestamp

string

required

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.

Responses

200OK

403Forbidden

500Internal Server Error

defaultAny bad or invalid request will lead to following error object