Refundable Payments
A standard for open, transparent, and automated refund processing for x402. Built for developers, designed for openness.
Currently in alpha · APIs may change
Transactions
Volume (USDC)
How It Works
Secure escrow-based payments with built-in refund protection and dispute resolution.
Non-Custodial
Escrow Contract
Few Lines to Enable Refunds
Deploy your operator contract, pick your arbiter, mark routes as refundable, and let the protocol handle the rest.
Resource Server
TypeScript
import { registerEscrowEvmScheme } from "@x402r/evm/escrow/server";
import { refundable } from "@x402r/helpers";
...
registerEscrowEvmScheme(server, { networks: NETWORK_ID });
app.use(
paymentMiddleware(
{
"GET /weather": {
accepts: [
refundable({
scheme: "escrow",
price: "$0.01",
network: NETWORK_ID,
payTo: account.address,
}, operatorAddress),
],
description: "Weather data",
},
},
server,
),
);Facilitator
TypeScript
import { registerEscrowEvmScheme } from "@x402r/evm/escrow/facilitator";
...
registerEscrowEvmScheme(facilitator, {
signer: evmSigner,
networks: NETWORK,
});Client
TypeScript
import { registerEscrowEvmScheme } from "@x402r/evm/escrow/client";
...
registerEscrowEvmScheme(client, {
signer,
networks: NETWORK,
});What People Say
See what developers and builders are saying about x402r.
@austingriffith
↩️ @x402rorg by BackTrackCo Paid for data with x402 but it didn't deliver what was promised? No big deal, just request your refund. Easy trust for agents & APIs! 🔥 https://t.co/TXMgyE4rIm https://t.co/6cnmMUMA4e
@ethereumfndn
3/ @x402rorg by BackTrackCo If you pay for data with x402 but it doesn’t deliver, this tool lets you request a refund. Easy trust for agents & APIs. https://t.co/suMIKtkDN4 https://t.co/u4Ju9iG0JK
@PryvitKyle
Shoutout @x402rorg First legit option that seems to try and tackle the paywall fraud issue I called out a few months ago. Happy to see someone show this is possible! Would love to see them add an opt in insurance pool that could be drawn from for protections
@ampersend_ai
one of the coolest x402 hackathon submissions 👀
@kamalbuilds
2> x402r by @AliAbdoli1234 - escrow-based refunds and dispute resolution for agent payments. solves what happens when an API fails after you paid. already live on ultravioleta facilitator. https://t.co/qeruYGfe3H
@OnchainExpat
shipped refundable x402 API payments via @x402rorg if the upstream call fails, your USDC comes back in 10 min. on-chain escrow, no trust required. 36 endpoints live — crypto, AI, audio, agent tools Demo: https://t.co/mYqmKsHj3R https://t.co/cz5NmX3VP4
@Executi0nMarket
We now has on-chain escrow. Gasless. When an AI agent creates a task, funds lock on-chain. When a human completes it, funds release instantly — zero gas for either side. Cancel? Refund in 0.32 seconds. No intermediary. No custody risk. Just @x402rorg on @base .
@austingriffith
↩️ @x402rorg by BackTrackCo Paid for data with x402 but it didn't deliver what was promised? No big deal, just request your refund. Easy trust for agents & APIs! 🔥 https://t.co/TXMgyE4rIm https://t.co/6cnmMUMA4e
@ethereumfndn
3/ @x402rorg by BackTrackCo If you pay for data with x402 but it doesn’t deliver, this tool lets you request a refund. Easy trust for agents & APIs. https://t.co/suMIKtkDN4 https://t.co/u4Ju9iG0JK
@PryvitKyle
Shoutout @x402rorg First legit option that seems to try and tackle the paywall fraud issue I called out a few months ago. Happy to see someone show this is possible! Would love to see them add an opt in insurance pool that could be drawn from for protections
@ampersend_ai
one of the coolest x402 hackathon submissions 👀
@kamalbuilds
2> x402r by @AliAbdoli1234 - escrow-based refunds and dispute resolution for agent payments. solves what happens when an API fails after you paid. already live on ultravioleta facilitator. https://t.co/qeruYGfe3H
@OnchainExpat
shipped refundable x402 API payments via @x402rorg if the upstream call fails, your USDC comes back in 10 min. on-chain escrow, no trust required. 36 endpoints live — crypto, AI, audio, agent tools Demo: https://t.co/mYqmKsHj3R https://t.co/cz5NmX3VP4
@Executi0nMarket
We now has on-chain escrow. Gasless. When an AI agent creates a task, funds lock on-chain. When a human completes it, funds release instantly — zero gas for either side. Cancel? Refund in 0.32 seconds. No intermediary. No custody risk. Just @x402rorg on @base .
Ecosystem Partners
Building the future of refundable payments with innovative partners across the ecosystem.
Features
Secure, standardized, and customizable refund infrastructure for merchants.
Non-Custodial
Funds are held in smart contract escrow - never by a third party. Only the merchant or buyer can receive the funds.
Arbiter Agnostic
Choose your own arbiter for dispute resolution. Transparent, configurable, and fully on-chain.
Transparent
Source-available contracts with on-chain verification and full traceability of all transactions.
Minimal Changes
Very little changes to your current code are required to enable refund functionality.
Configurable
Conditions, escrow periods, and fee structures are defined by the operator contract. Dispute resolution is pluggable per arbiter.
Flexible Fees
Operator contracts define fee structures on-chain. Transparent, verifiable, and fully configurable.
Frequently Asked Questions
Common questions about x402r and the refund protocol.