Developer Documentation

Comprehensive guides, API references, and resources to help you integrate our mobile recharge services into your applications.

Overview

🚀 Boost your business with our mobile recharge API!

Our Mobile Recharge API is a fast, secure, and scalable solution designed for resellers in Bangladesh. It enables seamless mobile top-ups for all major operators, including Grameenphone, Robi, Airtel, Banglalink, and Teletalk, with instant processing and high success rates. With easy API integration, resellers can quickly set up and start offering mobile recharges on their platform. We provide real-time transaction tracking, competitive pricing, and 24/7 support to ensure smooth operations. Whether you're a small business or an enterprise, our highly reliable API helps you expand your services and maximize profits effortlessly.

🚀 Start today and grow your business with our trusted recharge API!

Key Features

  • Phone number validation across multiple providers
  • Real-time access to available mobile plans and pricing
  • Secure transaction processing
  • Support for multiple telecom providers
  • Comprehensive error handling and status updates

API Integration Benefits

  • Automated Transactions - Process mobile recharges and banking transactions automatically without manual intervention
  • Business Growth - Scale your business by handling multiple transactions simultaneously through API integration
  • Real-time Processing - Get instant transaction processing and immediate status updates for all operations
  • Secure Integration - Enhanced security with API key authentication and IP whitelisting features

Quick Start

  1. Obtain your API key from the developer portal
  2. Retrieve available plans for the specific provider

Authentication

All API requests require authentication using your username and API key.

  • Username : Get from your profile in the dashboard after logging in
  • API Key: Get from API Settings in your dashboard
user: your_username
api_key: your_api_key

#Request API

Make API requests to process mobile recharges and banking transactions:

Request Body

Parameter Key Type Description Possible Values
service string Type of service to request bdrecharge
number string Mobile number for the transaction e.g., 01711XXXXXX
amount integer Transaction amount Range: 10-10000
operator string Make Sure operator Banglalink=BL
Robi=RB
Airtel=AT
Grameenphone=GP
Teletalk=TT
type string Type of transaction 1 - Prepaid
2 - Postpaid
3 - Skitto
user string Your reseller username e.g., RMBD
api_key string Your API authentication key Get from API Settings

Make API requests to perform mobile recharges and other transactions.

Code Examples

                                
                                <?php
                $url = '__API_URL__';
                $data = [
                    'service' => 'bdrecharge',
                    'number' => '01711XXXXXX',
                    'operator' => 'gp',
                    'amount' => 10,
                    'type' => 1,
                    'user' => 'RMBD',
                    'api_key' => 'E40QW2826263HMQ5B8S5903'
                ];

                $ch = curl_init($url);
                curl_setopt($ch, CURLOPT_POST, true);
                curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

                $response = curl_exec($ch);
                curl_close($ch);

                echo $response;
                ?>
                            

# Request Response Examples

200 Success Response

Position Success

 {
        "status": 200,
        "position": "Success",
        "balance": "36.38",
        "trxid": "172524030127",
        "datetime": "March 24, 2025 1:27 am",
        "message": "Recharge Successfull"
    }

Position Waiting

 {
        "status": 200,
        "position": "Waiting",
        "balance": "36.38",
        "trxid": "172524030127",
        "datetime": "March 24, 2025 1:27 am",
        "message": "Request successfully submitted"
    }
  • Success - Transaction completed successfully
  • Pending - Transaction is pending processing
  • Processing - Transaction is being processed
  • Waiting - Transaction is waiting in queue
  • Cancel - Transaction was cancelled

420 Error Response

Request failed due to validation or business logic error

{
        "status": 420,
        "message": "Error related message"
    }

500 API Not Found Error

When API Development mode is enabled

{
        "status": 500,
        "message": "Error related message"
    }

Status Tracking

Track the status of your transactions using the following API

Parameters:

Parameter Description
request_trxid Transaction ID to track
user Reseller Username
api_key Your API Key

Example Request

                            
                            
                            <?php
                            $url = "CURRENT_DOMAIN/api/request-status";
                            $postmethod = array(
                                "request_trxid" => "45566666",
                                "user" => "Rmbd",
                                "api_key" => "E40QW2826263HMQ5B8S5903"
                            );
                            $ch = curl_init($url);
                            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postmethod));
                            $response = curl_exec($ch);
                            curl_close($ch);
                            echo $response;
                            ?>
                            
                        

Response Examples

200 Success Response

{
                    "position": "Success",
                    "trxid": "BD5465656",
                    "lastbalance": "400.00",
                    "status": 10,
                    "message": "found your data"
                }

Position Status Values

  • Success - Transaction completed successfully
  • Pending - Transaction is pending processing
  • Processing - Transaction is being processed
  • Waiting - Transaction is waiting in queue
  • Cancel - Transaction was cancelled

500 API Not Found Error

{
                    "status": 500,
                    "message": "Api not found"
                }

# Offer Package Plans

Retrieve available offer packages for mobile operators.

POST

URL Parameters

Parameter Description Possible Values
operator Mobile operator name GP, RB, AT, BL, TT
user Your reseller username e.g., RMBD
api_key Your API authentication key Get from API Settings

Example Request

$url = getApiUrl();
$postmethod = array(
    "operator" => "GP",
    "user" => "Rmbd",
    "api_key" => "E40QW2826263HMQ5B8S5903"
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postmethod));
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Response

200 Success Response

{
    "offers": [
        {
            "id": 1,
            "operator": "GP",
            "title": "Internet Pack",
            "amount": 199,
            "validity": "30 Days"
        }
    ],
    "status": 200,
    "message": "Offers retrieved successfully"
}

400 Error Response

{
    "status": "error",
    "message": "Invalid operator code provided"
}

# Check Balance

Check your account balance and transaction history.

URL Parameters

Parameter Description
user Reseller Username
api_key Your API Key

Example Request

                            
                            
$url = "https://" + window.location.hostname + "/api/balance"; // Using the dynamic domain name
$postmethod = array(
    "user" => "RMBD",
    "api_key" => "E40QW2826263HMQ5B8S5903"
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postmethod));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
                            
                        

Success Response

200 Success

{
    "balance": "5000.00",
    "status": 10,
    "message": "found your account balance"
}

Error Responses

420 Authentication Error

{
    "status": 420,
    "message": "found your account balance"
}

500 API Not Found Error

{
    "status": 500,
    "message": "Api not found"
}