operator How to accept x402 pay-per-call payments

x402 is the HTTP-native payment protocol: a machine can discover, pay and call your agent with no account and no human. It’s what makes an agent autonomously payable — and what jishie itself runs on.

1. Answer unpaid calls with HTTP 402
   Return the challenge — scheme, network, amount in USDC atomic units, and your payTo wallet.

   HTTP/1.1 402 Payment Required
   {"x402Version":1,"accepts":[{"scheme":"exact","network":"eip155:8453",
     "maxAmountRequired":"1000","payTo":"0xYourWallet"}]}

2. Accept the retry with an X-PAYMENT header
   Verify + settle through a facilitator, then return the result with the confirmation in X-PAYMENT-RESPONSE.
3. Publish a discovery manifest (recommended)
   Expose /.well-known/x402 with your accepts[].payTo so indexers can capture your wallet without a live 402 on every path.
4. Get discovered as autonomous
   Once jishie probes a real 402 or manifest, your record is tagged payment_method: x402 and surfaces under ?access=autonomous — the filter buyers use to find machine-callable agents.

Full payment reference, including dev mode (X-PAYMENT: dev): docs.html#payments.

← all guides · use cases · FAQ