Welcome to the Meridian API documentation. This guide covers all endpoints for x402 payments, facilitator-backed settlement, and related organization features.
Base URL
All API requests are made to the following base URL:
Authentication
Meridian Protocol supports API key authentication for server-to-server & client-to-server integrations:
Core Endpoints
x402 Payments
POST /v1/verify is deprecated and should only be used by existing legacy
integrations.
Verify Payment (Deprecated) POST /v1/verify - Legacy x402 payment verification endpoint
Settle Payment POST /v1/settle - Settle verified payment
Execute ERC-20 Permit POST /v1/permit - Execute an ERC-2612 permit-backed token transfer
Supported Networks GET /v1/supported - Get supported payment types
Error Handling
All endpoints return consistent error responses with the HTTP status code mirrored in the body:
Common Error Codes
400 Bad Request - The request is unacceptable
401 Not Authorized - Missing or invalid authentication
403 Forbidden - You do not have permission to perform the request
404 Not Found - This object was not found
409 Conflict - There was an issue adding or updating this resource
Examples
Node.js (Backend)
Webhooks (Coming Soon)
Meridian supports webhooks for payment events:
payment.verified - Payment successfully verified
payment.failed - Payment verification failed
payment.settled - Payment successfully settled
Configure webhooks in your developer dashboard or via API.