Create token
Create and provision a new network token with a card scheme. See Network Tokens overview for creation sources and supported schemes.
Promoting a wallet token that was already promoted returns 422 with the classifier WALLET_TOKEN_ALREADY_PROMOTED; promoting a token that carries no funding PAN (a CRYPTOGRAM_3DS token) returns 422 with UNSUPPORTED_WALLET_TYPE. See Promotion for eligibility.
presentation_type needs agentic commerce support, a gated feature that must be activated for the instance. Without it, a request that carries the field returns 403 with the classifier FORBIDDEN. With it, agent for a card that is not provisioned with Visa Token Service returns 400 with NETWORK_TOKEN_NOT_SUPPORTED, or 422 with SCHEME_UNSUPPORTED for a wallet_token source.
Send X-Idempotency-Key to make the request safe to retry. A repeat returns the original outcome with Idempotent-Replayed: true instead of provisioning again; a key reused with a different request returns 422 IDEMPOTENCY_KEY_MISMATCH, and a repeat while the original runs returns 409 IDEMPOTENCY_KEY_IN_USE. See Idempotency.
Authorizations
Headers
Makes the write safe to retry. A repeat with the same key, by the same credential, with the same request within 24 hours returns the original outcome with Idempotent-Replayed: true instead of executing again. 1 to 255 visible ASCII characters, sent once. Must not contain card data. See Idempotency.
1 - 255^[!-~]+$"provision-7f3c2a9e-0001"
Body
The presentation type the network token is provisioned for. agent provisions it for agent-initiated payments. Supported with Visa Token Service only. Leave it out for an ordinary network token, which is provisioned with ecom.
Requires agentic commerce support, a gated feature that must be activated for the instance. Without it, any value returns 403.
ecom, agent Response
Success response
- Session
- Network Token
- Wallet Token Promotion
Which variant you get follows the request's source.type, and the three carry no shared tag field — tell them apart by shape.
- A
sessionsource returns the Session object (session_idonly). - A
panorpci_tokensource returns the Network Token. - A
wallet_tokensource returns Wallet Token Promotion, which nests the creatednetwork_tokenalongside the originatingsource.