Send the X-Aspra-Env: sandbox header for free testing without consuming float.
API Reference
v2Comprehensive REST API for super-app integrations — recharge, bill payment, cash-in, gift cards, vouchers, reconciliation, and webhooks.
Quick reference
Base URL
https://api.aspra.io/v1/publicAuth
Authorization: Bearer <client_id>.<secret>Idempotency
Idempotency-Key: <unique-id>Required on all mutations
Sandbox
X-Aspra-Env: sandboxFree testing, no float consumed
Rate limits
Starter
20 req/s
Up to 100k tx / mo
Growth
100 req/s
Volume tiered
Enterprise
Custom
Negotiated
Quickstart
Bill payment flow
# 1. Inquire bill
curl -X POST https://api.aspra.io/v1/public/bill/inquire \
-H "Authorization: Bearer pk_live_xxx.sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"billerCode":"taqa-abu-dhabi","accountNumber":"1234567890"}'
# 2. Pay
curl -X POST https://api.aspra.io/v1/public/bill/pay \
-H "Authorization: Bearer pk_live_xxx.sk_live_xxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"billerCode": "taqa-abu-dhabi",
"accountNumber": "1234567890",
"amountMinor": 15000,
"currency": "AED",
"billerRef": "<from-inquire>"
}'