# 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.

---