Authentication
Authenticate Merchant API requests with Bearer API keys.
All Merchant API routes live under /api/v1 and require:
Authorization: Bearer pk_test_… # or pk_live_…
| Key prefix | Mode | What it does |
|---|---|---|
pk_test_ | Test | Test invoices, mock addresses, simulate button. No real money. |
pk_live_ | Live | Real deposit addresses. Real crypto. |
The key's mode always wins. A test key cannot create a live invoice.
Idempotency
For POST creates, send Idempotency-Key: order-12345. Retries with the same key return the same invoice instead of creating a duplicate.