Quickstart
Make your first purchase in four requests.
1. Find the product
List products and pick a serviceID. Its pricing field tells you whether to send a plan code or an amount.
bash
curl https://instantrecharge.com.ng/api/v1/catalog/products2. Choose a plan
For plan-priced products (data, TV, PINs), list the plans and keep the code of the one your customer picks.
bash
curl "https://instantrecharge.com.ng/api/v1/catalog/variations?serviceID=mtn-data"3. Create the purchase
Send your own unique reference as the Idempotency-Key. If the request times out, retry with the same key and you'll get the same order back.
bash
curl -X POST https://instantrecharge.com.ng/api/v1/transactions \
-H "Authorization: Bearer $INSTANT_RECHARGE_KEY" \
-H "Idempotency-Key: inv-2026-000184" \
-H "Content-Type: application/json" \
-d '{"serviceID":"mtn-data","recipient":"08031234567","variationCode":"mtn-10mb-100"}'4. Confirm the result
Most orders come back with status delivered. If it's pending, check again with your reference until it's delivered or refunded.
bash
curl https://instantrecharge.com.ng/api/v1/transactions/inv-2026-000184 \
-H "Authorization: Bearer $INSTANT_RECHARGE_KEY"
