Skip to content
Storeware

Storeware x402 payment handler

ai.storeware.x402

A Storeware shop can be paid in USDC on Base by an agent holding a wallet, with no card and nobody in the loop. The handler is advertised on a checkout session when the shop has opted in, has a verified deposit address, and the basket is priced in US dollars.

How it works

  1. Read the checkout session. If this handler appears in capabilities.payment.handlers, its config is a complete x402 version 2 PaymentRequired, carrying the amount in atomic USDC units and the address to pay.
  2. Sign an EIP-3009 transferWithAuthorization for exactly that amount, to exactly that address, on the network named in accepts[0].network.
  3. Complete the checkout with the base64 payload as payment_data.instrument.credential.token, and credential.type set to x402.

What is checked

The requirements are rebuilt from the session when the payment arrives, never taken from the payload. An authorisation whose recipient, amount, token or network disagrees with what the shop published is refused, as is one whose signature does not recover to the account it claims to come from, and one whose validity window has closed.

What it costs you

There is no chargeback and no dispute process. Once the transfer settles it is final, which is a benefit to the merchant and a risk to the buyer, and both halves of that are true. A Storeware order paid this way cannot be refunded through the platform; a merchant refunding one sends the stablecoin back themselves.

Schemas