API reference

Base URL http://127.0.0.1:8080. Authenticate merchant routes with Authorization: Bearer <token>. Prefer the interactive OpenAPI explorer for try-it-out requests.

Verify

Preferred: POST /api/v2/verify with url or reference + bank. Sender field is account_number. Optional settlement_account, expected_amount, phone (CBE Birr).

curl -X POST http://127.0.0.1:8080/api/v2/verify \
  -H "Content-Type: application/json" \
  -d '{"bank":"telebirr","reference":"CKH7…"}'

Checkout

POST /api/v1/checkout/session requires success_url + failure_url. Settlement from settlement_accounts or saved accounts. Hosted pay page at paymentUrl.

Auth & tokens

POST /api/v1/auth/register|login, GET /api/v1/auth/me, token CRUD under /api/v1/auth/tokens.

Saved accounts

GET|POST|PUT|DELETE /api/v1/accounts - merchant settlement address book used as checkout defaults.

Status

GET /api/v1/status returns upstream component health (operational|slow|down). See also the status page.