Documentation v1.24
Last updated 2026-05-25 Give feedback

Payment Methods

MagicPay hides payment method details from users while routing agent sessions through the best available rail.

Payment method routing ladder

Channel Ranking

MagicPay ranks payment channels by fit for the purchase and by how much browser work can be avoided.

RankChannelUse when
1Agentic protocols such as x402The provider supports native agent payment
2Public MCP/APIThe provider exposes an official callable interface
3Reverse MCP/APIMagicPay can adapt to a provider flow without browser checkout
4Legacy browserThe purchase must happen through an ordinary website checkout

Purchase Operation Types

The same MagicCard interface supports one-time purchases, marketplace-attached cards, and recurring subscriptions.

  • One-time purchase: pay for goods such as tickets or website checkout items.
  • Marketplace purchase: attach a card to a marketplace account such as Amazon or Uber Eats.
  • Recurring payment: create a dedicated subscription card and manage renewals from MagicPay.

Protocol Philosophy

x402 and other agentic protocols are payment infrastructure, not user-facing complexity. The user should not need to think about the payment protocol, just as they do not think about payment rails when tapping a card.

MagicPay public documentation.