Create a delegated payment token

Request

Tokenizes a credential for controlled usage by the merchant's PSP per the Allowance constraints. Exactly one credential type is currently supported: card.

Security

bearerAuth

Authorizationstringrequired

Example:Bearer api_key_123

Content-Typestringrequired

Example:application/json

Accept-Languagestring

Example:en-us

User-Agentstring

Example:ChatGPT/2.0

Idempotency-Keystring

Example:idem_abc123

Request-Idstring

Example:req_123

Signaturestring

Example:ZXltZX...

Timestampstring, (date-time)

Example:2025-09-29T10:30:00Z

API-Versionstringrequired

Example:2025-09-29

Bodyapplication/jsonrequired

payment_methodobjectrequired

allowanceobjectrequired

billing_addressobject

risk_signalsArray of objects, non-emptyrequired

metadataobjectrequired

{
  "payment_method": {
    "type": "card",
    "card_number_type": "fpan",
    "number": "4242424242424242",
    "exp_month": "11",
    "exp_year": "2026",
    "name": "Jane Doe",
    "cvc": "223",
    "checks_performed": [
      "avs",
      "cvv"
    ],
    "iin": "424242",
    "display_card_funding_type": "credit",
    "display_brand": "visa",
    "display_last4": "4242",
    "metadata": {
      "issuing_bank": "temp"
    }
  },
  "allowance": {
    "reason": "one_time",
    "max_amount": 2000,
    "currency": "usd",
    "checkout_session_id": "csn_01HV3P3...",
    "merchant_id": "acme",
    "expires_at": "2025-10-09T07:20:50.52Z"
  },
  "billing_address": {
    "name": "John Doe",
    "line_one": "123 Fake St.",
    "line_two": "Unit 1",
    "city": "San Francisco",
    "state": "CA",
    "country": "US",
    "postal_code": "12345"
  },
  "risk_signals": [
    {
      "type": "card_testing",
      "score": 10,
      "action": "manual_review"
    }
  ],
  "metadata": {
    "campaign": "q4"
  }
}

Responses

Created

Headers

Request-Idstring

Echo of the request correlation ID

Bodyapplication/json

idstringrequired

Unique vault token identifier (vt_...)

createdstring, (date-time)required

metadataobjectrequired

Response

{
  "id": "vt_01J8Z3W4YZ9ABC",
  "created": "2025-09-29T11:00:00Z",
  "metadata": {
    "source": "agent_checkout",
    "merchant_id": "acme",
    "idempotency_key": "idem_abc123"
  }
}