Contact Adyen Support to enable network tokenization on your merchant account; ensure you have the Checkout webservice role and Merchant Recurring role on your API credential.
No integration change is required for Adyen-managed tokens: continue using your standard `/payments` request with a `storedPaymentMethodId` and Adyen will automatically swap the token for a network token before forwarding authorization.
To receive data about network token usage, go to Customer Area > Developers > Additional data and enable 'Include the retry attempts' (acquirer section) and 'Network token bin and summary for tokenised payments' (card section).
If you manage your own network tokens from card schemes, make the initial payment with `paymentMethod.type: networkToken` and supply `mpiData.tokenAuthenticationVerificationValue` (the TAVV cryptogram), `mpiData.directoryResponse: Y`, and `mpiData.authenticationResponse: Y`.
Save the `networkTxReference` value from the initial payment response; pass it in all subsequent unscheduled or subscription payments to maintain network compliance.
For co-badged network tokens in the US, call `POST /cardDetails` to list available networks then specify the preferred route using `paymentMethod.brand` in the `/payments` request.
Known gotchas
Adyen-managed network tokenization cannot be combined with external acquirer connections; it is only available for payments acquired by Adyen.
When using self-managed tokens, the TAVV must be passed in `mpiData.tokenAuthenticationVerificationValue` for Checkout API v68 and later; for v67 and earlier the field was called `mpiData.cavv`.
The `networkTxReference` returned in the initial payment response must be stored and reused for all subsequent payments in the same MIT/subscription chain; omitting it can cause network compliance failures.
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