Endpoint reference
Base URL: https://api.satlane.com (local / self-host: http://localhost:4000).
Invoice API (your server → ours)
| Method | Path | Notes |
|---|---|---|
POST | /v1/invoices | Create. API key. Send Idempotency-Key. |
GET | /v1/invoices | List with cursor pagination. |
GET | /v1/invoices/:id | Fetch one. |
POST | /v1/invoices/:id/cancel | Cancel pending. |
POST | /v1/invoices/:id/simulate | Test mode only; fire any event. |
Dashboard setup (vendor session and required verification)
Webhook endpoint configuration, secret rotation, delivery replay and the one-click test invoice are dashboard/session operations. They are not API-key invoice endpoints. Configure your store and webhook destination in the dashboard before beginning the server integration.
Public (buyer's browser → ours)
| Method | Path | Notes |
|---|---|---|
GET | /pay/invoices/:id | Invoice + store branding snapshot. |
GET | /pay/invoices/:id/events | SSE stream. |
GET | /pay/invoices/:id/stream | WebSocket alternative to SSE. |
CORS is open (Access-Control-Allow-Origin: *) on /pay/*.
Plan management, subscription invoices, and usage live in the vendor dashboard (
/billing). Billing routes require an authenticated merchant session. Store API keys cannot change subscription plans.