Merchant guides

Start with the merchant quickstart. It is the whole integration in one page: mint a merchant identity, list a product, stand up the referral endpoint, and prove the wiring with our readiness probe. It also has a prompt you can paste into the coding agent that owns your paid endpoint.

The pages below are the same ground at task depth — every error, every retry, every field. Read one when the quickstart has told you what to do and you need to know what happens when it goes wrong.

Nothing is deployed on a public chain yet — see Quickstart.

In the order you meet them

• Register your merchant identity — four calls, and the one order that works
• List a product — the commission rate and product type go on-chain; the name, description, category and endpoint come to us
• Accept agent payments over x402 — the referral endpoint in full, including every failure path
• Make your 402 self-describing — the extensions object an agent with no prior knowledge of this protocol can read
• Set commission and cashback — choosing a rate, what a change reaches, and why cashback has no merchant lever
• Accept an MPP charge — the other rail, where the buyer pays before you answer
• Read your merchant stats — the six counters, and what four of them are not

When you need the exact call

• Merchant routes — every /v1 merchant route and all five facilitator routes, field by field
• x402 and MPP charge — what runs between your 402 and your merchant net
• Payment flow — the arithmetic that decides your net