হোম / Developer Hub

Developer Hub: API ডকুমেন্টেশন

রিচার্জ, স্ট্যাটাস চেক ও ব্যালেন্স চেক API এবং Webhook ফরম্যাটের ডেমো ডকুমেন্টেশন। আপনার নিজস্ব API Key ও Secret লগইন করার পর ড্যাশবোর্ডে পাবেন।

ফ্রি রেজিস্টার করুন যোগাযোগ করুন

API Key ও Secret কোথায় পাবেন

ফ্রি রেজিস্টার করুন

অ্যাকাউন্ট খুলে লগইন করুন।

ড্যাশবোর্ড থেকে "API ডকুমেন্ট" খুলুন

বাম মেনুর API ডকুমেন্ট অপশনে আপনার নিজস্ব API Key ও API Secret দেখা যাবে।

Webhook URL সেট করুন

রিচার্জ সফল বা ব্যর্থ হলে সাথে সাথে নোটিফিকেশন পেতে ড্যাশবোর্ডে আপনার Callback URL সেভ করুন।

নিচের সব উদাহরণে YOUR_API_KEY ও YOUR_API_SECRET ডেমো মান। আসল Key ও Secret শুধু লগইন করার পর আপনার ড্যাশবোর্ডে পাবেন। Secret কাউকে দেবেন না এবং ফ্রন্টএন্ড বা পাবলিক কোডে রাখবেন না।

এন্ডপয়েন্টসমূহ

সব রিকোয়েস্ট POST মেথডে পাঠাতে হবে।

1. রিচার্জ রিকোয়েস্ট API

POST https://topup.tzalmamun.com/api/recharge.php

// PHP cURL উদাহরণ
$ch = curl_init("https://topup.tzalmamun.com/api/recharge.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'api_key'    => 'YOUR_API_KEY',
    'api_secret' => 'YOUR_API_SECRET',
    'number'     => '017XXXXXXXX',
    'amount'     => 50,
    'operator'   => 'GP',
    'type'       => 'prepaid',
    'trxid'      => 'TXN_' . time()
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$res = json_decode($response, true);

2. স্ট্যাটাস চেক API

POST https://topup.tzalmamun.com/api/status.php

// স্ট্যাটাস চেক করার কোড
$ch = curl_init("https://topup.tzalmamun.com/api/status.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'api_key' => 'YOUR_API_KEY',
    'trxid'   => 'YOUR_TRXID'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = json_decode(curl_exec($ch), true);
// $res['recharge_status'] => 'Success', 'Pending' বা 'Failed'

3. ব্যালেন্স চেক API

POST https://topup.tzalmamun.com/api/balance.php

// ব্যালেন্স চেক কোড
$ch = curl_init("https://topup.tzalmamun.com/api/balance.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'api_key'    => 'YOUR_API_KEY',
    'api_secret' => 'YOUR_API_SECRET',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = json_decode(curl_exec($ch), true);
// $res['balance'] => বর্তমান ব্যালেন্স

Webhook Payload Format

রিচার্জ প্রসেস সম্পন্ন হলে আপনার Webhook URL-এ নিচের JSON ফরম্যাটে ডাটা যাবে।

{
    "trxid": "YOUR_TRXID",
    "status": "Success",
    "number": "017XXXXXXXX",
    "amount": 50.00
}

প্যারামিটার ও স্ট্যাটাস

প্যারামিটার	বিবরণ
api_key / api_secret	আপনার API পরিচয়
number	রিচার্জের মোবাইল নম্বর
amount	রিচার্জের পরিমাণ
operator	অপারেটর, যেমন GP
type	prepaid বা postpaid
trxid	আপনার নিজস্ব ইউনিক ট্রানজেকশন আইডি

recharge_status	অর্থ
Success	রিচার্জ সফল
Pending	প্রসেসিং চলছে
Failed	রিচার্জ ব্যর্থ

সাধারণ জিজ্ঞাসা

API Key কোথায় পাব?

রেজিস্টার ও লগইন করার পর ড্যাশবোর্ডের "API ডকুমেন্ট" পেজে আপনার নিজস্ব Key ও Secret দেখা যাবে।

API অ্যাক্সেসে কত চার্জ?

API অ্যাক্সেস নিতে ৫০ টাকা চার্জ।

রিচার্জের ফলাফল কীভাবে জানব?

স্ট্যাটাস চেক API ব্যবহার করুন অথবা Webhook URL সেট করুন, ফলাফল সাথে সাথে আপনার সাইটে পৌঁছে যাবে।

আরও জানুন

রিচার্জ API SMS গেটওয়ে নিরাপত্তা

আজই শুরু করুন

ফ্রি অ্যাকাউন্ট খুলে রিচার্জ ব্যবসা চালু করুন।

ফ্রি রেজিস্টার করুন