Decaf Disbursements API

Getting Started

1. Get sandbox and production API keys from the Decaf integrations team.
2. Fund sandbox balance: POST /v1/sandbox/fund
3. Create your first disbursement in sandbox.
4. Register and verify webhook signatures.
5. Switch to production base URL + production key.

Sandbox fund

POST /v1/sandbox/fund
{ "amountUsd": "10000.00" }

Create first disbursement

curl -X POST https://sandbox.api.decaf.so/v1/disbursements \
  -H "Authorization: Bearer sk_sandbox_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientPhone": "+15005550001",
    "amountUsd": "50.00",
    "reference": "test-001",
    "idempotencyKey": "test-001-v1"
  }'

Register webhook

curl -X POST https://sandbox.api.decaf.so/v1/webhooks \
  -H "Authorization: Bearer sk_sandbox_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-ngrok-or-server.com/webhooks/decaf",
    "events": ["disbursement.delivered", "disbursement.failed"],
    "secret": "your-signing-secret"
  }'

Support

• Integration support: integrations@decaf.so
• API status: status.decaf.so
• Include X-Request-ID in bug reports.