Payments API
Record, list, summarize, and void payments through the public `/payments` API.
The public payments API is:
/paymentsDocumented Endpoints
| Method | Path | Purpose |
|---|---|---|
GET | /payments | list payments |
GET | /payments/pending | list pending payments |
GET | /payments/summary | fetch summary data |
GET | /payments/invoice/{invoiceId} | fetch payment status for one invoice |
POST | /payments | record a payment |
POST | /payments/{id}/void | void a payment record |
List Payments
GET /payments
GET /payments/pendingQuery Parameters
| Parameter | Type | Description |
|---|---|---|
limit | number | Results per page (1-100, default 50) |
offset | number | Number of payment records to skip (default 0) |
GET /payments also accepts clientId, startDate, and endDate filters.
Record a Payment
curl -X POST https://api.conduitt.io/payments \
-H "Authorization: Bearer ck_test_your_key" \
-H "Content-Type: application/json" \
-d '{
"invoiceId": "550e8400-e29b-41d4-a716-446655440000",
"amount": "250.00",
"paidAt": "2026-03-28T14:30:00.000Z",
"paymentMethod": "bank_transfer",
"notes": "Wire received"
}'Notes
amountis sent as a decimal string- these docs do not describe a separate partial-payment configuration API
- treat Stripe connection state and payment recording as related but distinct concerns