One API to send mobile top-ups
from your own app

Add airtime top-ups to your platform in a day. You handle your customers and your checkout — we handle operator detection, provider connections and delivery across six countries.

Or email support@afgtopup.com

⚡ Instant delivery

Credit typically reaches the phone within about a minute.

💳 Prepaid balance

No invoicing, no credit risk. Load credit, spend it as you go.

🔍 Auto operator detection

Pass a phone number, we identify the network for you.

How the integration works

Four calls, one afternoon of work. Your backend talks to our API — nothing runs in the browser.

1
List operatorsYour customer picks a country and you show the supported networks.
2
Detect operatorPass the phone number and we identify the network automatically — no manual selection errors.
3
Get priceFetch the exact cost in euros before the customer pays, so you can display a firm price and add your own markup.
4
Send top-upOnce your customer has paid you, call send. The cost is deducted from your balance and the credit is delivered.
# after your customer pays on your platform POST /partner-topup X-API-Key: your_api_key { "phone": "+93712345678", "amount": 100, "country": "AF", "operator_id": 1, "external_id": "your_order_12345" } # 202 Accepted — queued, delivery follows { "success": true, "status": "processing" }

Pass your own order ID as external_id and retries are safe — a network timeout can never cause a double top-up.

Countries you can reach

Major networks covered in each market, including all five Afghan operators.

🇦🇫 Afghanistan 🇵🇰 Pakistan 🇩🇿 Algeria 🇲🇦 Morocco 🇳🇬 Nigeria 🇰🇪 Kenya

In Afghanistan the API covers Afghan Wireless (AWCC), Roshan, Etisalat Afghanistan, Salaam and ATOMA. Operator coverage in each country is returned live by the API, so your integration stays current without code changes on your side.

At a glance

ItemDetail
Billing modelPrepaid balance — no invoicing, no credit risk
DeliveryAsynchronous, typically under a minute
IdempotencyYour order ID prevents duplicate charges on retry
AuthenticationServer-side API key, backend calls only
Confirmation emailsOptional — sent to your customer if you pass their email
SupportDirect contact with the team, not a ticket queue

Transaction limits, rate limits and commercial terms are confirmed when your account is set up.

Who this is for

App developers

Add top-ups as a feature inside an app your users already use.

Shops & agents

Sell top-ups from your own counter or website with your own pricing.

Diaspora platforms

Offer airtime alongside whatever else you already do for your community.

Frequently asked questions

What does the API let me build?

You can add mobile top-ups to your own app, website or platform. Your users enter a phone number and an amount, and the credit is delivered to that number. Delivery, operator detection and provider connections are handled on our side.

Afghanistan, Pakistan, Algeria, Morocco, Nigeria and Kenya, covering the major mobile networks in each. In Afghanistan that includes Afghan Wireless (AWCC), Roshan, Etisalat, Salaam and ATOMA.

It runs on a prepaid balance. You load credit to your partner account, and each top-up deducts its cost from that balance. There is no invoicing and no credit risk on either side, and you set your own markup when charging your own customers.

Yes. You collect payment from your customers however you prefer, then call the API to deliver the top-up. We handle delivery to the mobile network, not your checkout.

Top-ups are queued immediately and credit typically reaches the recipient's phone within about a minute. You can pass your own order ID so retries never cause a double charge.

Contact us with a short description of your platform and expected volume. We will review it and send you API credentials along with the full integration guide.

Get API access

Message us and we'll set up your partner account, send your API key privately, and share the full integration guide.

Tell us three things and we can set you up quickly:
  • What you're building — app, website or shop
  • Which countries you need
  • Roughly how many top-ups per month you expect
View the Node.js starter kit on GitHub

Open-source client library with all four endpoints — browse the code before you commit.