From a5fd9b0b912ca6e60a1bcd635638e6b4f8f13d84 Mon Sep 17 00:00:00 2001 From: AyushBherwani1998 Date: Fri, 15 May 2026 10:51:00 +0530 Subject: [PATCH 1/4] add an overview section for x402 --- gator-sidebar.js | 1 + smart-accounts-kit/guides/x402/overview.md | 60 ++++++++++++++++++++++ 2 files changed, 61 insertions(+) create mode 100644 smart-accounts-kit/guides/x402/overview.md diff --git a/gator-sidebar.js b/gator-sidebar.js index d1f191d6607..5e7d451cba5 100644 --- a/gator-sidebar.js +++ b/gator-sidebar.js @@ -118,6 +118,7 @@ const sidebar = { label: 'x402', collapsed: true, items: [ + 'guides/x402/overview', { type: 'category', label: 'Buyer', diff --git a/smart-accounts-kit/guides/x402/overview.md b/smart-accounts-kit/guides/x402/overview.md new file mode 100644 index 00000000000..3888cc37d1a --- /dev/null +++ b/smart-accounts-kit/guides/x402/overview.md @@ -0,0 +1,60 @@ +--- +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 microtransaction 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 using MetaMask Smart Accounts Kit. +These guides walk you through creating delegations, requesting permissions, and setting up recurring payments. + + From 898ffd3dffac906a53fe6c20c4c339e9a2afb3a4 Mon Sep 17 00:00:00 2001 From: AyushBherwani1998 Date: Fri, 15 May 2026 11:00:13 +0530 Subject: [PATCH 2/4] fix tpyo --- smart-accounts-kit/guides/x402/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/smart-accounts-kit/guides/x402/overview.md b/smart-accounts-kit/guides/x402/overview.md index 3888cc37d1a..c9c71de808e 100644 --- a/smart-accounts-kit/guides/x402/overview.md +++ b/smart-accounts-kit/guides/x402/overview.md @@ -12,7 +12,7 @@ import CardList from '@site/src/components/CardList' [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 microtransaction to retrieve premium onchain analytics data. +dapp can charge users a micropayment to retrieve premium onchain analytics data. ## ERC-7710 payments From bda7a06ed0582b4c3de55d486f754317ba2b0bc4 Mon Sep 17 00:00:00 2001 From: AyushBherwani1998 Date: Fri, 15 May 2026 11:05:51 +0530 Subject: [PATCH 3/4] fix typo --- smart-accounts-kit/guides/x402/overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/smart-accounts-kit/guides/x402/overview.md b/smart-accounts-kit/guides/x402/overview.md index c9c71de808e..b075ea651f4 100644 --- a/smart-accounts-kit/guides/x402/overview.md +++ b/smart-accounts-kit/guides/x402/overview.md @@ -12,7 +12,7 @@ import CardList from '@site/src/components/CardList' [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 micropayment to retrieve premium onchain analytics data. +dapp can charge users a micro-payment to retrieve premium onchain analytics data. ## ERC-7710 payments From 3c02982b51f0aa44ed115001b4cbe9eae3d60c18 Mon Sep 17 00:00:00 2001 From: AyushBherwani1998 Date: Fri, 15 May 2026 15:32:43 +0530 Subject: [PATCH 4/4] add seller guide --- smart-accounts-kit/guides/x402/overview.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/smart-accounts-kit/guides/x402/overview.md b/smart-accounts-kit/guides/x402/overview.md index b075ea651f4..2c2c03807b1 100644 --- a/smart-accounts-kit/guides/x402/overview.md +++ b/smart-accounts-kit/guides/x402/overview.md @@ -34,12 +34,18 @@ Learn more [ERC-7710 delegations](../../concepts/delegation/overview.md). ## Guides -Get started with x402 payments using MetaMask Smart Accounts Kit. -These guides walk you through creating delegations, requesting permissions, and setting up recurring payments. +Get started with x402 payments in Smart Accounts Kit. +These guides walk you through seller endpoint setup and buyer payment flows.