Overview

One simple API. That's all you need.

How It Works

Interface402 has one job: verify x402 payments. We made it as simple as possible.

Payment Verification

Send us a payment proof, we tell you if it's legit. That's it.

Use this for:

• Accepting x402 payments in your API

• Verifying crypto payments without blockchain knowledge

• Getting paid for digital services

• Pretty much everything else

View Payment Verification →

Real-Time Notifications (Optional)

Want to know the instant someone pays you? Use WebSockets.

Use this for:

• Real-time payment notifications

• Building payment dashboards

• Monitoring transactions live

• Being notified immediately when money hits

View WebSocket API →

Base URL

All API endpoints are accessible via:

https://api.interface402.dev

Authentication

All requests require authentication via API key:

Authorization: Bearer YOUR_API_KEY

See Authentication for details.

Response Format

Success Response

{
  "success": true,
  "data": {
    // Response data
  },
  "timestamp": 1697234567890
}

Error Response

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {}
  },
  "timestamp": 1697234567890
}

What You Need to Send

Just three things:

Field	What It Is
payment_proof	The payment proof from x402 (we verify it)
amount	How much you expect to get paid
recipient	Your wallet address (where the money goes)

Rate Limits

Don't go crazy on the API:

Plan	Requests/Minute
Free	100/min
Paid	1,000/min
Enterprise	However many you need

See Rate Limits →

No SDK Required

Use whatever HTTP library you want. Curl, fetch, axios, requests—we don't care. It's just HTTP.

Want examples? Check out the examples →