API & Webhooks

API keys

Base URL: https://echoroam.com/api/open/v1 · Auth: Authorization: Bearer wk_live_…

No API keys yet.

Webhook

We POST signed events (eSIM fulfilled, order updates) to your URL. Verify with the EchoRoam-Signature header (Stripe-style t=…,v1=… HMAC-SHA256 of t.body).

Endpoints

POST /api/open/v1/package/list      catalog (eSIM Access shape)
POST /api/open/v1/esim/order/create   buy an eSIM (idempotent on transactionId)
POST /api/open/v1/esim/query          order/eSIM detail (orderId|orderNo|iccid)
POST /api/open/v1/esim/topup           list & apply top-up packages
POST /api/open/v1/esim/cancel         cancel unactivated eSIM (wallet refund)
GET  /api/open/v1/balance             wallet balance