/api/v1/payments
Create an idempotent payment
API VERSION 1.0 · SANDBOX
Build payments into your product.
Authenticate server-to-server with a FABS key. Never embed API secrets in browser code or distribute the master provider credentials.
CORE ENDPOINTS
A small, stable merchant contract.
Provider-specific request differences stay behind the FABS connector while merchants use one consistent API.
/api/v1/balance
Read current and available balances
/api/v1/withdrawals
Request a governed payout
/health
Inspect environment readiness
curl -X POST /api/v1/payments \
-H "X-FABS-Key: fabs_test_..." \
-H "Idempotency-Key: order-1048" \
-H "Content-Type: application/json" \
-d '{"amount_minor":845000,"currency":"KES","rail":"mpesa","merchant_reference":"ORDER-1048"}'
-H "X-FABS-Key: fabs_test_..." \
-H "Idempotency-Key: order-1048" \
-H "Content-Type: application/json" \
-d '{"amount_minor":845000,"currency":"KES","rail":"mpesa","merchant_reference":"ORDER-1048"}'