Refunds
How the x402 Refunds system protects buyers and rewards quality sellers.
Refunds
Dexter integrates with x402refunds.com to offer verification-gated refund protection. Buyers get confidence that quality-verified endpoints are backed by refund guarantees. Sellers who maintain high-quality endpoints earn this trust badge automatically.
How It Works
- AI Verification scores every endpoint (0-100)
- High-scoring endpoints (70+) get refund protection headers
- Buyers see the refund guarantee before paying
- If something goes wrong, buyers can claim a refund
For Buyers
Refund Eligibility
Not all endpoints offer refund protection. Look for the refund headers in the API response:
| Header | Meaning |
|---|---|
Link: <mailto:...>; rel="refund-contact" | You can email for refund support |
Link: <https://...>; rel="refund-request" | One-click refund available |
Both headers present = Full refund protection (endpoint scored 70+ and passed verification)
Only contact header = Partial protection (endpoint scored 50-69) — email support for case-by-case review
No headers = No refund protection (endpoint unverified or low score)
How to Request a Refund
If an endpoint has refund protection and you receive a bad response:
-
Gather your evidence:
- The transaction signature from your payment
- The response you received
- Why it didn't meet expectations
-
File a claim:
- Use the refund-request URL from the response headers, OR
- Email the refund-contact address
-
Automatic processing:
- Claims against verified endpoints (score 70+) are auto-approved
- You'll receive your USDC back to the wallet that paid
What Qualifies for a Refund?
| Scenario | Refundable? |
|---|---|
| Endpoint returned an error after payment | ✅ Yes |
| Response was empty or gibberish | ✅ Yes |
| Response didn't match endpoint description | ✅ Yes |
| You changed your mind | ❌ No |
| Response was correct but you didn't like it | ❌ No |
| Endpoint had no refund headers | ❌ No |
Rate Limits
To prevent abuse:
- 3 claims per payer per day (auto-approved)
- 5 claims per payer per week against the same seller
- Excessive claims trigger manual review
For Sellers
Earning Refund Protection
Your endpoints automatically earn refund protection when they:
- Pass AI Verification with status
pass - Score 70 or higher on quality evaluation
See AI Verification for how scoring works.
Protection Tiers
| Score | Status | Refund Headers | What It Means |
|---|---|---|---|
| 70-100 | Pass | Both (contact + request) | Full protection — buyers see refund guarantee |
| 50-69 | Pass | Contact only | Partial — buyers can email, case-by-case |
| 0-49 | Pass/Fail | None | No protection — buyers assume risk |
| Any | Unverified | None | Not yet tested |
Why This Benefits You
Refund protection is a trust signal:
- Buyers are more likely to try endpoints with refund guarantees
- Your high scores become a competitive advantage
- Quality sellers naturally rise to the top
You're protected too:
- Refunds only apply to endpoints that were verified at time of payment
- If verification later fails, existing payments aren't affected
- Fraudulent claims are blocked by rate limits and manual review
Monitoring Refund Claims
In your Seller Dashboard, you can see:
- Claims filed against your endpoints
- Approval/denial status
- Your refund rate (lower is better)
High refund rates may trigger review of your endpoints. Consistently refunded endpoints may be flagged for manual verification.
Improving Your Score
If your endpoints don't have refund protection:
- Check your verification status
- Review the AI's feedback on why you scored low
- Fix the issues and trigger re-verification
- Once you hit 70+, refund headers appear automatically
Technical Details
HTTP Headers
Refund information is conveyed via RFC 8288 Link headers.
On 402 (Payment Required) responses:
On 200 (Success) responses after payment:
Filing a Refund
Refund claims are processed by x402refunds.com. When you see the refund-request header, you can file directly through their service:
- Via their API — POST to
https://api.x402refunds.com/v1/refunds - Via their website — x402refunds.com
x402refunds handles the claim processing and payout. Dexter maintains refund credits with x402refunds to cover approved claims.
Claim Statuses
| Status | Meaning |
|---|---|
pending | Claim received, processing |
approved | Auto-approved, refund queued |
denied | Auto-denied (not eligible) |
manual_review | Escalated for human review |
refunded | Refund completed |
rejected | Manual review rejected claim |
FAQ
Why doesn't my endpoint have refund headers?
Check your AI Verification score. You need:
- Status:
pass - Score: 70 or higher
Can I opt out of refund protection?
No. Refund protection is automatic for qualifying endpoints. It's a feature, not a liability — it signals quality to buyers.
What if someone abuses the refund system?
We have multiple safeguards:
- Per-payer daily/weekly limits
- Per-seller claim velocity monitoring
- Manual review for suspicious patterns
- IP-based rate limiting
Abusers get flagged and blocked.
Do refunds come from my wallet?
No. Refunds are paid from Dexter's credit balance with x402refunds.com. Sellers are not directly debited. However, consistently refunded endpoints may face review.
How fast are refunds processed?
- Auto-approved claims: Within minutes
- Manual review: 24-48 hours
I'm a buyer and my claim was denied. What now?
If auto-denied, you can:
- Email
[email protected]with your claim details - Provide additional evidence
- A human will review your case
Need Help?
- Refund questions: [email protected]
- Seller verification: AI Verification docs
- General support: Telegram

Refunds