Skip to main content

Invoices & Receipts

AfriRoute generates a receipt for every wallet top-up and a consolidated invoice for each billing period. This page explains how to access them, what they contain, and how to automate retrieval for your accounting workflow.

Two Documents, Two Purposes​

DocumentWhen issuedPurpose
Top-up receiptImmediately after each wallet top-upProof of payment into your wallet
Usage invoiceMonthly (or on demand)Itemized summary of what you consumed

Because AfriRoute is pre-funded, the usage invoice is a statement of consumption drawn against funds you already deposited — it is not a bill you must pay separately (except on Enterprise credit terms).

View Invoices​

curl "https://api.afriroute.ai/api/v1/billing/invoices?year=2026" \
  -H "Authorization: Bearer $AFRIROUTE_API_KEY"
{
  "invoices": [
    {
      "invoice_id": "inv_2026_04",
      "period": "April 2026",
      "total": 1324.80,
      "currency": "USD",
      "status": "paid",
      "pdf_url": "https://invoices.afriroute.ai/inv_2026_04.pdf"
    }
  ]
}

Generate an Invoice for a Custom Period​

curl -X POST https://api.afriroute.ai/api/v1/billing/invoice/generate \
  -H "Authorization: Bearer $AFRIROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "period_start": "2026-05-01", "period_end": "2026-05-28" }'

Anatomy of an Invoice​

{
  "invoice_id": "inv_2026_05",
  "period": "1–28 May 2026",
  "billing_entity": {
    "name": "MyCommerce Ltd",
    "tax_id": "RC123456",
    "country": "NG"
  },
  "line_items": [
    { "description": "SMS — Nigeria (delivered)", "quantity": 84210, "unit_price": 0.0098, "total": 825.26 },
    { "description": "SMS — Kenya (delivered)",   "quantity": 31040, "unit_price": 0.0120, "total": 372.48 },
    { "description": "Number lookups",            "quantity": 5000,  "unit_price": 0.0030, "total": 15.00 }
  ],
  "subtotal": 1212.74,
  "volume_discount": -97.02,
  "tax": { "type": "VAT", "rate": 0.075, "amount": 83.68 },
  "total": 1199.40,
  "currency": "USD",
  "fx_note": "Settled from KES balance at 1 USD = 129.4 KES",
  "pdf_url": "https://invoices.afriroute.ai/inv_2026_05.pdf"
}

Tax Handling​

AfriRoute applies the correct indirect tax based on your billing entity's country (for example 7.5% VAT in Nigeria, 16% VAT in Kenya). Register your tax ID once and it appears on every invoice for compliant input-tax reclaim:

curl -X PATCH https://api.afriroute.ai/api/v1/billing/entity \
  -H "Authorization: Bearer $AFRIROUTE_API_KEY" \
  -d '{ "legal_name": "MyCommerce Ltd", "tax_id": "RC123456", "country": "NG" }'

Download Receipts​

Each top-up returns a receipt URL, also retrievable later:

curl "https://api.afriroute.ai/api/v1/wallet/receipts/top_abc123" \
  -H "Authorization: Bearer $AFRIROUTE_API_KEY"

Automated Delivery​

Have invoices emailed to your finance team automatically each month:

curl -X PATCH https://api.afriroute.ai/api/v1/billing/settings \
  -H "Authorization: Bearer $AFRIROUTE_API_KEY" \
  -d '{ "auto_email_invoices": true, "recipients": ["[email protected]"], "format": "pdf" }'

Enterprise Credit Terms​

Enterprise customers can switch from pre-funded to Net-30 invoiced billing. In this mode the monthly invoice becomes a payable with a due date, and usage is not gated by a wallet balance. Contact [email protected] to arrange terms.

Invoice questions? [email protected]

Last Updated: May 2026