Mobile rechargeAPI

The Success TopUp API accepts JSON payloads over HTTPS. Every request is sent to https://api.successtopup.com unless you are using the documentation sandbox (mock responses only).

• Protocol: HTTPS
• Encoding: UTF-8 JSON
• Header: Content-Type: application/json

Include your credentials in the JSON body of each request (not in the URL):

Request body

Use in the operator field.

Operator	Code
Grameenphone	GP
Robi	RB
Airtel	AT
Banglalink	BL
Teletalk	TT
Skitto	SK
Brilliant	BT

Minimal recharge call — swap in your keys.

const axios = require('axios');

await axios.post('https://api.successtopup.com/api/recharge', {
  number: '01712345678',
  type: 'prepaid',
  operator: 'GP',
  amount: 50,
  trxid: String(Date.now()),
  successtopup_key: process.env.STU_KEY,
  successtopup_secret: process.env.STU_SECRET,
}, { headers: { 'Content-Type': 'application/json' } });

Submit a prepaid or postpaid recharge. Use a unique trxid for every transaction.

Body parameters

Example response

{
  "result": true,
  "message": "Recharge successful"
}

Check the status of a recharge using the same trxid you sent.

Body parameters

Example response

{
  "result": true,
  "status": "Success"
}

List offers (regular or drive) optionally filtered by operator.

Body parameters

Example response

{
  "result": true,
  "drives": []
}

Return account balance and drive balance.

Body parameters

Example response

{
  "result": true,
  "balance": 0,
  "driveBalance": 0
}

Utility bill payment (see billOperator codes in your integration guide).

Body parameters

Example response

{
  "result": true,
  "message": "Bill payment transaction successful"
}