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. You can either poll this endpoint (pull) or set a webhook in API settings to receive status updates automatically (push).

Webhook setup and token verification: Webhook Security

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

If you set a Webhook Token in your API page, every webhook POST from Success TopUp includes this header:

x-webhook-token: YOUR_WEBHOOK_TOKEN

• Verify this header before processing the webhook payload.
• If the token is missing or invalid, return HTTP 401/403 and ignore the request.
• Rotate the token anytime from your API settings page.

Webhook payload

From recharge status updates, webhook payload is sent as a compact JSON object. Current statuses sent are Success, Cancel, and Processing.

{
  "status": "Success",
  "transactionId": "ST17138666251234",
  "comment": "Recharge Success",
  "note": "Recharge Success",
  "updatedAt": "2026-04-23T10:15:12.000Z"
}

This payload is pushed by cron when recharge status changes. For on-demand lookup, call /api/status with the same trxid.