402Pay API Endpoints

Core Endpoints

Method
Endpoint
Description

GET

/api/:resource

Returns data or HTTP 402 if payment required.

POST

/verify-payment

Confirms on-chain payment proof.

GET

/analytics

Fetches usage, revenue, and token distribution logs.


Example 402 Response

{
  "status": 402,
  "requestId": "req_58a7b",
  "recipient": "6DHU...xPq9",
  "amount": "0.002",
  "currency": "402G",
  "acceptedMints": ["402G", "USDC", "SOL"],
  "instructions": "Pay and resend with Payment-Proof header"
}

Example Payment Proof Request

> GET /api/data
Payment-Proof: tx=7qH...GHv; requestId=req_58a7b; payer=4wA...uCz

< HTTP/1.1 200 OK
{
  "status": "verified",
  "message": "Access granted",
  "data": {...}
}

Last updated