Create Card Account

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
string
required

Unique identifier as defined by BillDesk for each merchant

string
required

Unique ID generated by the merchant for each request

string
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

card
object
required
string
required
authentication_data
object
required
Headers
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.

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.

string
required

Request Content-Type to take the values application/jose

string
required

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

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json