Invoices

Invoices are the core merchant payment object.

Create invoice

POST /api/v1/invoice/create

Typical request fields:

{
  "merchantId": "merchant-uuid",
  "chainKey": "ethereum",
  "tokenSymbol": "USDC",
  "amount": "100.00",
  "memo": "Order #12345",
  "expiresInMinutes": 60,
  "privacyLevel": "standard"
}

List invoices

GET /api/v1/invoice

Requires merchant authentication.

Invoice status

GET /api/v1/invoice/{id}/status

Returns public or rate-limited status information for an invoice.

Invoice details

GET /api/v1/invoice/{id}

Requires merchant authentication.

Cancel invoice

POST /api/v1/invoice/{id}/cancel

Cancels an invoice when payment is no longer expected.

Mark or process payment

POST /api/v1/invoice/{id}/pay

Used by authenticated backend flows to associate payment activity with an invoice and trigger webhook delivery.