Skip to main content

Create a virtual card

You can issue as many different Virtual Cards for each of your customers using our APIs. This may be a Virtual Card just for one-time use, or a Virtual Card which can be used for multiple purchases. Each Virtual Card will have a unique 16-digit card number (PAN), expiration date and CVV value.

note

In our APIs a Virtual Card is referred to as a static_token.

To create a Virtual Card, use the Provision account API, with the following parameters:

  • type set to static_token
  • instrument set to manual_card_entry

The tenant_customer_ref and tenant_account_ref are required fields and need to be filled with a reference to your customer and their account.

tip

Use the tenant_account_ref if you want to distinguish different funding sources. But if customers do not have multiple accounts in your system, you may also choose to copy value of tenant_customer_ref in this field.

Sample request

Headers:
  Idempotency-Key: 40709949-0712-487c-a2fe-1dd2e64af506
Payload
{
  "type": "static_token",
  "tenant_customer_ref": "customer-00000000000001",
  "tenant_account_ref": "FR00000000000001",
  "tenant_token_ref": "TOK000000000000001",
  "instrument": "manual_card_entry"
}

Sample response

{
    "id":"c2319421-f0e8-4dd6-a099-124c5a3c6592",
    "customer_id": "24ae8cd0-301d-4b2b-807b-09683f334bdd",
    "instrument":  "manual_card_entry",
    "locked": false,
    "status": "active",
    "tenant_account_ref": "FR00000000000001",
    "tenant_customer_ref": "customer-00000000000001",
    "tenant_token_ref": "TOK000000000000001",
    "tsp_token_ref": "DSHRMC1PH0000000038d38f98a6a45b7863199720778380e",
    "account_id": "436605a1-271d-49a7-80f0-bcaf095cdd6a",
    "created_at": "2024-03-20T14:05:14.711+08:00",
    "updated_at": "2024-03-20T14:05:14.711+08:00"
}