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

{
  "tenant_account_ref": "FR00000000000001",
  "tenant_customer_ref": "customer-00000000000001",
  "of_customer_id": "40095c2f-d391-4e06-94d9-cf0b3191c548",
  "of_account_id": "5bafb9bc-9573-4acf-b686-04bf62c81af8",
  "customer_id": "40095c2f-d391-4e06-94d9-cf0b3191c548",
  "account_id": "5bafb9bc-9573-4acf-b686-04bf62c81af8",
  "static_token_id": "180106f9-8177-42fa-99bf-23ae8d785636",
  "instrument": "manual_card_entry",
  "status": "active",
  "locked": false,
  "created_at": "2026-03-10T10:27:58.253Z",
  "updated_at": "2026-03-10T10:27:58.253Z"
}