Ensure network tokenization is enabled on your Checkout.com account (it is enabled by default for Visa and Mastercard); confirm your account's `{prefix}` base URL from the Dashboard under API endpoints.
Request asynchronous provisioning (the default) by including `processing.provision_network_token: true` in a standard `POST /payments` request; the initial payment processes via full PAN while the card is tokenized in the background.
For synchronous provisioning (initial payment held until token is ready), contact your Checkout.com account manager to enable it, then call `POST /network-tokens` with the instrument ID or full card details.
On subsequent payments, Checkout.com automatically swaps the stored card for its network token; inspect `processing.pan_type_processed` in the response to confirm `fpan` vs network token usage.
To export a token and cryptogram for use with a third-party acquirer, call `GET /network-tokens/{id}` to retrieve the `tokenNumber`, then `POST /network-tokens/{id}/cryptograms` with the `transaction_type` to obtain a single-use cryptogram.
Subscribe to the network token lifecycle webhook to receive token update events; Checkout.com auto-retries on specific error codes (20003, 20030, 20068, 20091, 20096) using FPAN fallback.
Known gotchas
FPAN fallback is enabled by default when a network-token payment is declined with specific error codes; this may incur higher scheme fees in some regions. Opt out explicitly via your account manager if needed.
The `{prefix}` in all API base URLs is unique to your account and environment (sandbox vs production); retrieve it from the Dashboard before writing any endpoint paths.
Cryptograms are unique to the token, the merchant, and the transaction; they are single-use and must be generated fresh for each authorization attempt.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp