Skip to main content

Create Network Token

POST/v2/network_tokens

Creates a network token for a given card. The token is provisioned by the card network and can be used for subsequent transactions.

A token may be returned with status requested (newly created) or active (already exists for this card and enrollment).

card_numberStringrequired
Full PAN digits (12-19 digits)
expiry_monthIntegerrequired
Card expiry month (1-12)
expiry_yearIntegerrequired
Card expiry year including century (e.g. 2027)
card_cvvString
Card verification code (3 digits)
card_holderString
Name of the cardholder (alphanumeric, max 120 chars)
emailString
Email of the cardholder
phoneString
Phone number of the cardholder
billing_countryString
Country code in ISO 3166-1 alpha-2
billing_cityString
City of the billing address
billing_line1String
Address line 1
billing_line2String
Address line 2
billing_postal_codeString
Postal code (alphanumeric, no spaces)
billing_stateString
State or province
postback_urlString
HTTPS URL to receive postback notifications for this token. Overrides the merchant-level default if provided.
Example Request
POST /v2/network_tokens
Authorization: Basic <base64(api_key:api_password)>
Content-Type: application/json
{
"card_number": "4111111111111111",
"expiry_month": 12,
"expiry_year": 2027,
"card_cvv": "123",
"card_holder": "Joe Cardholder",
"email": "joe@example.com",
"phone": "+491234567890",
"billing_country": "DE",
"billing_city": "Berlin",
"billing_line1": "Alexanderplatz 1",
"billing_postal_code": "10178"
}

Response​

idString
UUID of the network token
merchant_idString
UUID of the merchant
statusString
Token status: requested, active, suspended, failed, archive_pending, archived
typeString
Token type (currently always merchant)
networkString
Card network: visa or mastercard
providerString
Token provider identifier
last_token_refreshString
Timestamp of last token refresh from the network
errorObject
Error object with code and detail (only present if status is failed)
created_atString
Creation timestamp
updated_atString
Last update timestamp
Example Response
{
"result": "OK",
"data": {
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "merchant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "requested",
  "type": "merchant",
  "network": "visa",
  "provider": "vts",
  "last_token_refresh": null,
  "created_at": "2026-03-31T10:15:22Z",
  "updated_at": "2026-03-31T10:15:22Z"
}
}
Last updated on