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
Ryze	RY

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. Use a billOperator code from the list in this section.

Body parameters

Operator codes

Use the code as shown in billOperator (case-sensitive).

Palli Bidyut (prepaid)pbp

Palli Bidyut (Postpaid)pbd

DESCO (Prepaid)dsp

DESCO (Postpaid)dsd

NESCO (Prepaid)nsp

NESCO (Postpaid)nsd

DPDC (Prepaid)dpp

DPDC (Postpaid)dpd

Titas Gasttg

Karnaphuli Gaskrp

Jalalabad gasjlb

Sundarban Gassbg

Bakhrabad Gasbrd

Amber IT (internet)art

DADhaka WASADAWA

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.