DexterDexter

DexterRefunds

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

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Seller    │────▶│  AI Verify  │────▶│   Score     │
│  Endpoint   │     │   System    │     │  70+ Pass   │
└─────────────┘     └─────────────┘     └──────┬──────┘


┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Buyer     │────▶│  402/200    │────▶│   Refund    │
│  Request    │     │  Response   │     │  Headers    │
└─────────────┘     └─────────────┘     └─────────────┘
  1. AI Verification scores every endpoint (0-100)
  2. High-scoring endpoints (70+) get refund protection headers
  3. Buyers see the refund guarantee before paying
  4. 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:

HeaderMeaning
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:

  1. Gather your evidence:

    • The transaction signature from your payment
    • The response you received
    • Why it didn't meet expectations
  2. File a claim:

    • Use the refund-request URL from the response headers, OR
    • Email the refund-contact address
  3. 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?

ScenarioRefundable?
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:

  1. Pass AI Verification with status pass
  2. Score 70 or higher on quality evaluation

See AI Verification for how scoring works.

Protection Tiers

ScoreStatusRefund HeadersWhat It Means
70-100PassBoth (contact + request)Full protection — buyers see refund guarantee
50-69PassContact onlyPartial — buyers can email, case-by-case
0-49Pass/FailNoneNo protection — buyers assume risk
AnyUnverifiedNoneNot 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:

  1. Check your verification status
  2. Review the AI's feedback on why you scored low
  3. Fix the issues and trigger re-verification
  4. 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:

HTTP/1.1 402 Payment Required
Link: <mailto:[email protected]>; rel="https://x402refunds.com/rel/refund-contact"

On 200 (Success) responses after payment:

HTTP/1.1 200 OK
Link: <mailto:[email protected]>; rel="https://x402refunds.com/rel/refund-contact", <https://api.x402refunds.com/v1/refunds>; rel="https://x402refunds.com/rel/refund-request"; type="application/json"

Filing a Refund

Refund claims are processed by x402refunds.com. When you see the refund-request header, you can file directly through their service:

  1. Via their API — POST to https://api.x402refunds.com/v1/refunds
  2. Via their websitex402refunds.com

x402refunds handles the claim processing and payout. Dexter maintains refund credits with x402refunds to cover approved claims.

Claim Statuses

StatusMeaning
pendingClaim received, processing
approvedAuto-approved, refund queued
deniedAuto-denied (not eligible)
manual_reviewEscalated for human review
refundedRefund completed
rejectedManual 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:

  1. Email [email protected] with your claim details
  2. Provide additional evidence
  3. A human will review your case

Need Help?