Create Card Account

post

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

A card account (or card token) can be created by providing the card details and a customer reference.

The API will provide a cardaccount object as a response, with a unique cardaccountid, that can be used to initiate a transaction.

Body Params

mercid

string

required

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

Unique identifier as defined by BillDesk for each merchant

orderid

string

required

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

Unique ID generated by the merchant for each request

customer_refid

string

required

^[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

card

object

required

coft_consent

string

required

authentication_data

object

required

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