Skip to main content
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.