Implement Mastercard Agent Pay to issue Agentic Tokens for agent-initiated purchases and signal them correctly in authorization messages

domain: www.mastercard.com/us/en/business/artificial-intelligence/mastercard-agent-pay.html · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Engage a Mastercard-certified processor or your existing acquirer to enable Agent Pay on your merchant account; Agent Pay reached broad processor availability in 2026 following a phased rollout starting with Microsoft, IBM, and Braintree in April 2025
  2. Understand the Agentic Token structure: it is an extension of the Mastercard Digital Enablement Service (MDES) token that binds a tokenized card credential to a specific agent identity, merchant scope, and consent policy with configurable spend caps, merchant restrictions, and expiration windows
  3. On the authorization message, populate program_id field with the value for an Agent Pay transaction (Mastercard added dedicated values to the digital_commerce_data object effective April 17, 2026) so that issuers and processors can identify and correctly route the agent-initiated transaction
  4. Implement real-time token revocation handling: if a consumer revokes an agent's authorization through their issuer app, the Agentic Token is invalidated at the network level and the next auth attempt will fail — surface this failure to the agent as a specific error code distinct from a generic decline
  5. For cross-protocol use, understand that Mastercard Agent Pay participates in the Universal Commerce Protocol (UCP) coalition alongside Visa, Google, Stripe, and others; Agentic Tokens slot into the AP2 Payment Mandate flow when that protocol layer is used
  6. Test token lifecycle scenarios in the Mastercard sandbox: successful authorization, revocation mid-session, spend cap exhaustion, and merchant restriction violation

Known gotchas

Related routes

Use Mastercard Agentic Tokens (MDES extension) to bind a tokenized card credential to a specific AI agent and merchant scope
developer.mastercard.com/mastercard-checkout-solutions/documentation/use-cases/agent-pay · 5 steps · unrated
Enroll in the Mastercard Agent Pay for Machines (AP4M) protocol and issue Verifiable Intent credentials for your agent so it can transact across Mastercard's card and stablecoin rails
www.mastercard.com/us/en/business/artificial-intelligence/mastercard-agent-pay.html · 5 steps · unrated
Integrate Google Pay payment tokens into an agent-driven merchant-initiated transaction (MIT) flow using the Google Pay API and Universal Commerce Protocol
developers.google.com/pay/api · 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