diff --git a/gator-sidebar.js b/gator-sidebar.js index ede83a74de3..b7b06e49407 100644 --- a/gator-sidebar.js +++ b/gator-sidebar.js @@ -119,6 +119,7 @@ const sidebar = { collapsed: true, key: 'x402-guides', items: [ + 'guides/x402/overview', 'guides/x402/seller', { type: 'category', diff --git a/smart-accounts-kit/guides/x402/overview.md b/smart-accounts-kit/guides/x402/overview.md new file mode 100644 index 00000000000..2c2c03807b1 --- /dev/null +++ b/smart-accounts-kit/guides/x402/overview.md @@ -0,0 +1,66 @@ +--- +description: Use x402 and ERC-7710 delegations to enable programmatic payments from MetaMask smart accounts. +sidebar_label: Overview +keywords: [x402, HTTP 402, ERC-7710, delegation, facilitator, payments, smart account] +--- + +import GlossaryTerm from '@theme/GlossaryTerm' +import CardList from '@site/src/components/CardList' + +# x402 Payments + +[x402](https://www.x402.org/) is an open payment protocol that uses the HTTP `402` status code to enable programmatic, machine-to-machine payments over HTTP. It allows servers to charge for API access without requiring buyer accounts, API keys, or traditional payment infrastructure. + +For example, an AI agent can pay 0.01 USDC per request to access a weather API, or a +dapp can charge users a micro-payment to retrieve premium onchain analytics data. + +## ERC-7710 payments + +The standard x402 protocol supports direct token transfers (using ERC-20 Permit2 or EIP-3009). +[ERC-7710](https://eips.ethereum.org/EIPS/eip-7710) extends this by enabling delegation-based +payments from MetaMask smart accounts. + +With ERC-7710, a buyer's smart account creates a delegation that authorizes the facilitator +to transfer tokens on their behalf. The buyer doesn't sign a direct token approval. +Instead, they sign a delegation that the facilitator redeems during settlement. + +This approach enables buyers to pay from MetaMask wallet. +Buyers can restrict delegations to specific facilitator addresses, amounts, and time windows +using delegation scopes. +They can also create long lived delegations that allow recurring payments without re-signing +for each request. + +Learn more [ERC-7710 delegations](../../concepts/delegation/overview.md). + +## Guides + +Get started with x402 payments in Smart Accounts Kit. +These guides walk you through seller endpoint setup and buyer payment flows. + +