Tokenise a Payment Card
  • 02 Dec 2024
  • 1 Minute to read
  • Dark
    Light

Tokenise a Payment Card

  • Dark
    Light

Article summary

Payment Card Tokenisation Overview

Payment card tokenisation is the process of substituting a card's Primary Account Number (PAN) with a randomly generated number, known as a token. This token acts as a unique identifier and cannot be traced back to the original card data, providing enhanced security for transactions. Tokenisation is a key component of payment security and can be applied not only to credit cards but also to debit cards and digital wallets.

For more detailed information on card tokenisation, you can refer to the following [resource].

PCI Compliance

If you achieve SAQ D PCI certification, you can utilize the following endpoint to create a card token.

For those without this level of PCI certification, we recommend us our hosted payment page. The card token will be sent as part of callback notification on a succesful payment.

Card Tokenisation API

Creating a Token

To tokenise a card, use the endpoint provided below. The following details must be included in your request:

  • Cardholder Name
  • Card Number
  • Expiry Month
  • Expiry Year

Optionally, you may also pass the ClientAccount parameter to associate the tokenised card with a specific client account.

Once processed, the card will be tokenised, and any associated client account will be linked to the generated token.

Endpoint

POST /api/cards/tokenise Try it here

Retrieving a Token

To retrieve the details of a tokenised card, use the following endpoint. The card token is a required parameter in the request. This will allow you to access the information linked to the tokenised card securely.

Endpoint

GET /api/cards/tokens/{cardToken} Try it here

Deleting a Token

You can delete a tokenised card by using the endpoint provided below. The card token is a required parameter for this action. Once processed, the token will be permanently removed, and all associated card details will be securely deleted.

Endpoint

DELETE /api/cards/tokenise Try it here


Was this article helpful?