Build on the merchant DD API
Server-to-server integration at /api/v1/dd. API key or JWT auth. Payer-facing checkout BFF is track A2 — not shipped yet.
Current endpoints
| Method | Path | Note |
|---|---|---|
| POST | /api/v1/dd/mandates | Create mandate |
| POST | /api/v1/dd/mandates/{id}/status/refresh | Refresh mandate status |
| POST | /api/v1/dd/mandates/{id}/debits | Submit collection |
| GET | /api/v1/dd/debits/{id} | Debit status |
Quick start
curl -X POST https://api.example.com/api/v1/dd/mandates \
-H "X-TZD-API-Key: tzdk_..." \
-H "Content-Type: application/json" \
-d '{"customerReference":"001","payerName":"Jane W.","currency":"KES",...}'