API Reference

Base URL: https://agents.gwop.io

Authentication

Most endpoints require a merchant API key as a Bearer token:

Authorization: Bearer sk_m_...

The Get invoice endpoint is public and requires no authentication.

Method	Path	Auth	Description
`POST`	`/v1/invoices`	`sk_m_*`	Create an invoice
`GET`	`/v1/invoices`	`sk_m_*`	List your invoices
`GET`	`/v1/invoices/{id}`	Public	Retrieve an invoice
`POST`	`/v1/invoices/{id}/cancel`	`sk_m_*`	Cancel an open invoice

Status	Terminal	Meaning
`OPEN`	No	Awaiting payment
`PAYING`	No	Payment in progress — do not create a new invoice
`PAID`	Yes	Settlement confirmed on-chain
`EXPIRED`	Yes	TTL reached before payment
`CANCELED`	Yes	Canceled by merchant

All errors follow this format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": {},
    "requestId": "req_abc123"
  }
}

Every response includes an x-request-id header for debugging.