How do I request an x402 payment refund?

To request an x402 payment refund, POST your transaction details to https://api.x402refunds.com/v1/refunds. Required fields: blockchain (base or solana), transactionHash, sellerEndpointUrl, and description. You can also use the web form at https://x402refunds.com/request-refund.

What is the x402 refund process?

The x402 refund process: 1) File a refund request with your transaction hash 2) We verify the USDC payment on-chain 3) The merchant receives an email notification 4) Merchant approves, denies, or offers partial refund 5) If approved, refund is executed automatically to your wallet.

What information do I need to file an x402 refund?

You need: 1) The blockchain (base or solana) 2) Your transaction hash (0x... for Base, base58 for Solana) 3) The seller's API endpoint URL you paid 4) A description of what went wrong. Optional: evidence URLs and source transfer log index for multi-transfer transactions.

Where can I find the x402 refund API schema?

The complete JSON Schema for x402 refund requests is available at https://api.x402refunds.com/v1/refunds/schema. This machine-readable schema describes all required and optional fields, formats, and constraints.

What blockchains does x402refunds.com support?

X402Refunds supports USDC payments on Base (Ethereum L2) and Solana mainnet. Both native USDC and bridged USDC (USDbC) are supported on Base.

How long does x402 refund processing take?

Refund requests are processed in real-time. The merchant is notified immediately via email. Processing time depends on merchant response - most merchants respond within 24 hours. Once approved, the refund is executed within minutes.

Can AI agents file x402 refund requests?

Yes, AI agents can file refund requests via the API at POST https://api.x402refunds.com/v1/refunds. The API returns self-healing error responses with schema and recovery hints, enabling agents to correct mistakes and retry automatically.

X402Refunds - x402 Payment Refund Requests