v1

latestOpenAPI 3.0.12026-08-062379143.9 KB
Tokenization

Tokenize credit card

NOTE that the full URL for this API call is https://api.na.bambora.com/scripts/tokenization/tokens. Turn a credit card into a token using this service. This helps lessen your PCI scope by not passing the credit card information to your server. Instead you turn the card number into a token in the client app, then send the token to the server. When you send the token to Bambora to make a payment, Bambora then looks up the card number from that token and makes the payment. Tokens can also be used to create payment profiles.

post/scripts/tokenization/tokens

Request body

numberstring required

The credit card number

expiry_monthstring required

eg. 02 for February.

expiry_yearstring required

eg. 17 for 2017.

cvdstring required

Security code on the back of the credit card.

Response

Token response object. One will always be returned even if the data or card is invalid. The validity of the card is not checked with this API call.

tokenstring required

The token representing the credit card number that you will send for purchases. You will always receive a token, even if the request data is wrong or the card is invalid.

codestring

Response code for the message. It can be ignored.

versioninteger

Message version number. Can be ignored.

messagestring

Response message with any hints as to what might have gone wrong, if something went wrong.