Core APIs
Invoices API
Single-use payment links you can send to a specific client. Auto-closes after payment.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /gateway/api/invoices/ | Create an invoice |
| GET | /gateway/api/invoices/ | List (paginated) |
| GET | /gateway/api/invoices/<slug>/ | Retrieve |
| DELETE | /gateway/api/invoices/<slug>/ | Close |
Create example
curl -X POST https://blockcade.app/gateway/api/invoices/ \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"title": "INV-2026-042",
"amount": 500,
"currency": "USD",
"description": "Q3 consulting"
}'Node.js SDK
const inv = await bc.invoices.create({
title: 'INV-2026-042', amount: 500, currency: 'USD',
});
console.log('Send this to client:', inv.url);