Card

Create a Card Tokenization Intent

post

Creates a new intent for card tokenization. This process securely collects card details that can later be used for transactions without needing to store raw card data on your systems.

Authorizations

Body

external_idstringRequired

A unique identifier (e.g., UUID) from the merchant side to reference this tokenization request. This helps correlate the newly generated card token with a specific user or account in your system.

Example: 496de72d-d4a4-45eb-b426-3d04d2078a85

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /intents/card HTTP/1.1
Host: test.api.us.sanctuspay.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "external_id": "496de72d-d4a4-45eb-b426-3d04d2078a85"
}

200

New card tokenization intent created.

{
  "intent_id": "int_01J5XCMDXCFXCAQ1BV8HVG6644",
  "reference_id": "496de72d-d4a4-45eb-b426-3d04d2078a85",
  "valid_for": 60000
}