Choose between card-on-file and network tokens for repeat agent purchases

domain: agentic-payments · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Understand the distinction: card-on-file (CoF) stores the raw PAN or a PSP vault token tied to the PAN; network tokens (issued by Visa, Mastercard via their token services) are scheme-level tokens that are merchant-specific and automatically updated when the underlying card is reissued.
  2. For agent use cases with repeat purchases at known merchants, prefer network tokens where your PSP supports them: they reduce decline rates on card reissuance (the token stays valid even when a new physical card is issued), and they reduce PAN exposure.
  3. To use network tokens: store the customer's payment method in your PSP vault at the time of the first customer-present transaction; the PSP handles token provisioning with the card network behind the scenes; for subsequent agent-initiated charges, reference the PSP payment method ID (which maps to the network token).
  4. For CoF fallback (where network tokens are not available): store only the PSP's payment method ID, never the raw PAN; update the stored method when the customer reports a new card or when a charge fails with a 'card expired' or 'card number changed' decline code.
  5. For agent-initiated off-session charges, set the appropriate MIT (merchant-initiated transaction) flag on the charge to signal the card network that the cardholder is not present; this affects interchange rates and 3DS liability.
  6. Audit which payment method type is in use for each charge and track decline rates by method type; this informs whether to prioritize network token rollout.

Known gotchas

Related routes

Implement network tokenization for a card-on-file payment flow (Visa Token Service or Mastercard Digital Enablement Service)
banking-general · 6 steps · unrated
Understand the role of the original network transaction ID in distinguishing cardholder-initiated versus subsequent recurring transactions across Visa and Mastercard
Advanced auth · 6 steps · unrated
Correctly flag recurring and merchant-initiated transactions (MIT) versus cardholder-initiated transactions (CIT) to meet card network compliance requirements
Advanced auth · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans