Send the X-Aspra-Env: sandbox header for free testing without consuming float.

API Reference

v2

Comprehensive 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/public

Auth

Authorization: Bearer <client_id>.<secret>

Idempotency

Idempotency-Key: <unique-id>

Required on all mutations

Sandbox

X-Aspra-Env: sandbox

Free 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>"
  }'

Full reference