এপিআই দিয়ে কী করা যাবে?

এপিআই দিয়ে রিচার্জ, রিচার্জ অফার, ড্রাইভ অফার ও বিল পেমেন্ট চালানো যাবে; ব্যালেন্স দেখা যাবে; আর প্রতিটি রিকোয়েস্টের স্ট্যাটাস জিজ্ঞেস করা যাবে।

এপিআই কী কীভাবে পাবো?

অ্যাকাউন্টে লগইন করে এপিআই পাতা (/user/api) থেকে এপিআই চালু করলে কী পাওয়া যাবে। কী দিয়ে আপনার অনুরোধ চেনা যাবে, আর এপিআই পাতাতেই কী পরিচালনা করা যাবে।

অনুরোধ কীভাবে যাচাই হয়?

প্রতিটি অনুরোধ HMAC-স্বাক্ষর দিয়ে যাচাই হয়। স্বাক্ষর না মিললে অনুরোধ গ্রহণ করা হবে না।

লেনদেনের ফলাফল কীভাবে জানবো?

স্ট্যাটাস জানতে POST /api/status-এ trxid দিয়ে, অথবা POST /api/requests/{id}-এ request_id দিয়ে জিজ্ঞেস করুন। ওয়েবহুক বসালে স্ট্যাটাস বদলালেই আপনার সার্ভারে জানিয়ে দেওয়া হবে।

দাম ও চার্জ কীভাবে ঠিক হয়?

দাম, চার্জ ও লিমিট সবসময় সার্ভার-সাইড ডেটাবেস থেকে যাচাই হয় — অনুরোধে পাঠানো দাম গ্রহণ করা হয় না।

এপিআইয়ের রিকোয়েস্ট হিসাব কোথায় দেখা যাবে?

এপিআইয়ের প্রতিটি রিকোয়েস্ট একই টেবিল ও হিসাব-ইতিহাসে থাকে — অ্যাডমিনে ইউজার-রিকোয়েস্টের মতোই দেখা যাবে।

যেকোনো সফটওয়্যারের জন্য রিচার্জ এপিআই

আপনার সিস্টেম থেকেই রিচার্জ চালান, নিরাপদভাবে।

এপিআই ডকুমেন্টেশন দেখুন কীভাবে কাজ করে

এপিআই অনুরোধ

স্বাক্ষর যাচাই → রিচার্জ → স্ট্যাটাস

অনুরোধের ধাপ

স্বাক্ষর যাচাই

স্ট্যাটাস জিজ্ঞেস করুন

এপিআই-এর আওতা

রিচার্জ এপিআই — আপনার সিস্টেমের ভেতরেই রিচার্জ-ব্যবসা

এই এপিআই আপনার নিজের সফটওয়্যার থেকে সরাসরি রিচার্জ চালানোর জন্য — এপিআই আপনার নিজের অ্যাকাউন্টেই চলে। এপিআই দিয়ে রিচার্জ-সংক্রান্ত কাজ করা যায় — আওতা পরিষ্কারভাবে ঠিক করা আছে, যাতে পরিকল্পনা করার সময় কোনো ধোঁয়াশা না থাকে।

রিচার্জ

আপনার সিস্টেম থেকে গ্রাহকের নম্বরে রিচার্জ চালান। দেশের সব অপারেটরে রিচার্জ করা যায়, আর ব্যালেন্স ও হিসাব আপনার নিজের অ্যাকাউন্টেই থাকবে।

রিচার্জ অফার

রিচার্জ অফার দেখে বেছে গ্রাহকের নম্বরে বিক্রি করুন — রিচার্জের মতোই, এপিআই দিয়ে। ইন্টারনেট অফার ও মিনিট অফার রিচার্জ অফারের ভেতরেই পড়ে।

ড্রাইভ অফার

ড্রাইভ অফার দেখে বেছে গ্রাহকের নম্বরে বিক্রি করুন — এপিআই দিয়ে।

বিল পেমেন্ট

এপিআই দিয়ে বিল পরিশোধ করুন — কোন বিলার-কোড গ্রহণ করা হয়, তা ডকুমেন্টেশনে দেখুন।

এপিআই চালু করতে এপিআই পাতায় (/user/api) যান — লগইন করে সেখানেই কী নেওয়া যাবে।

শুরু করা

এপিআই শুরু করতে চারটি ধাপ

কী নেওয়া থেকে স্ট্যাটাস জিজ্ঞেস করা পর্যন্ত — প্রতিটি ধাপ আলাদা, যাতে পরীক্ষা শেষ না করে আসল পরিবেশে যাওয়া না লাগে।

১

এপিআই চালু করে কী নিন

অ্যাকাউন্টে লগইন করে এপিআই পাতা (/user/api) থেকে এপিআই চালু করুন — কী একবার দেখানো হবে, তাই নিরাপদে সংরক্ষণ করুন।
২

HMAC-স্বাক্ষর তৈরি করুন

প্রতিটি অনুরোধে method, path, timestamp ও body দিয়ে canonical স্ট্রিং বানিয়ে HMAC-স্বাক্ষর করুন — স্বাক্ষর না মিললে অনুরোধ গ্রহণ করা হবে না।
৩

quote নিয়ে রিচার্জ পাঠান

আগে quote এন্ডপয়েন্টে দাম ও চার্জ যাচাই করুন, তারপর recharge এন্ডপয়েন্টে অনুরোধ পাঠান — উত্তরে request_id ও txn_id আসবে।
৪

স্ট্যাটাস জিজ্ঞেস করুন

request_id দিয়ে POST /api/requests/{id}-এ জিজ্ঞেস করলে রিকোয়েস্টের স্ট্যাটাস জানা যাবে (pending, processing, success, failed) — অথবা ওয়েবহুক বসিয়ে নিন।

যা জানা দরকার

এপিআই ব্যবহারের আগে চারটি কথা পরিষ্কার থাকুক

এই চারটি কথা না বুঝে এপিআই বেছে নিলে পরে ভুল বোঝাবুঝি হয় — তাই শুরুতেই পরিষ্কারভাবে দেওয়া হলো।

এপিআই আপনার নিজের অ্যাকাউন্টেই চলে

এপিআই আলাদা অ্যাকাউন্ট নয় — আপনার নিজের অ্যাকাউন্টের ব্যালেন্স ও হিসাবই ব্যবহার হয়; এপিআইয়ের রিকোয়েস্ট অ্যাডমিনে আপনার রিকোয়েস্টের মতোই দেখা যাবে।

শুধু ডেভেলপারদের জন্য নয়

এই এপিআই শুধু ডেভেলপারদের জন্য নয় — যেকোনো সফটওয়্যার বা যার রিচার্জ এপিআই লাগবে, তিনি সরাসরি ব্যবহার করতে পারবেন।

দেশের সব অপারেটরে রিচার্জ

এই এপিআই দিয়ে দেশের সব অপারেটরে রিচার্জ করা যায় — একটি ইন্টিগ্রেশনেই সব অপারেটরের রিচার্জ-কাজ চলে।

রিচার্জে আপনার লেভেল-কমিশনই প্রযোজ্য

এপিআই দিয়ে রিচার্জ করলে অ্যাপের মতোই আপনার লেভেল অনুযায়ী কমিশন ও চার্জ প্রযোজ্য হবে — আলাদা কোনো নিয়ম নেই।

অপারেটর শর্ট কোড

প্রতিটি অপারেটরের শর্ট কোড

নিচের টেবিল landing-settings.json-এর operators ম্যাপিং থেকে আসে — সেটিংসে কোড বদলালে টেবিলও বদলে যাবে, কোড এডিট লাগবে না। কোড ব্যবহারকারীর নির্দেশ অনুযায়ী: গ্রামীণফোন GP, স্কিটো GP-ই (গ্রামীণফোনের কোডই ব্যবহার করে), রবি RB, এয়ারটেল AT, বাংলালিংক BL, ব্রিলিয়ান্ট BT, টেলিটক TT। আসল এপিআই-অনুরোধে অপারেটর operator_id দিয়ে চেনা হয়।

অপারেটর	শর্ট কোড	স্লাগ
গ্রামীনফোন	`GP`	`grameenphone`
স্কিটো	`GP`	`skitto`
রবি	`RB`	`robi`
এয়ারটেল	`AT`	`airtel`
বাংলালিংক	`BL`	`banglalink`
ব্রিলিয়ান্ট	`BT`	`brilliant`
টেলিটক	`TT`	`teletalk`

দ্রষ্টব্য: রবি/এয়ারটেলের কোড ব্যাকএন্ড 040 মাইগ্রেশনের robi/airtel থেকে আলাদা — ব্যবহারকারীর নির্দেশে সেটিংস-ম্যাপিংয়ে RB/AT বসানো হয়েছে। স্কিটো ও ব্রিলিয়ান্টের সারি ব্যাকএন্ড সীডে নেই, ব্যবহারকারীর নির্দেশে যুক্ত — স্কিটো গ্রামীণফোনের কোড (GP) ব্যবহার করে।

স্যান্ডবক্স

স্যান্ডবক্সে পরীক্ষা করুন — এপিআই পাতায়

আসল লেনদেনের আগে স্যান্ডবক্সে পরীক্ষা করুন — এপিআই পাতায় প্রতিটি এন্ডপয়েন্টের নিচে স্যান্ডবক্স-টেস্টার আছে। এই পাতায় কোনো সিমুলেশন-ফর্ম নেই।

স্যান্ডবক্স — এপিআই পাতায়

লগইন করে এপিআই পাতায় (/user/api) যান — সেখানেই প্রতিটি এন্ডপয়েন্টের নিচের টেস্টারে পরীক্ষা করতে পারবেন। মক রেসপন্স আসে, আসল টাকা বা ব্যালেন্স ছাড়াই পুরো প্রবাহ পরীক্ষা করুন।

এপিআই পাতায় যান

নমুনা-উত্তর (201)

{
  "success": true,
  "message": "recharge send successful",
  "data": {
    "request_id": 123,
    "txn_id": "SR202611092030001234",
    "kind": "recharge",
    "status": "pending",
    "service": "recharge",
    "operator_name": "Grameenphone",
    "mobile_number": "01700000000",
    "amount": "100",
    "commission_amount": "2.00",
    "points_earned": 0,
    "created_at": "2026-11-09 20:30:00"
  },
  "errors": null
}

নমুনা উদাহরণ

নমুনা অনুরোধ ও উত্তরের উদাহরণ

নিচের উদাহরণগুলো আসল অনুরোধ/উত্তরের আকৃতি দেখায় — এগুলো উদাহরণ মাত্র, আসল ক্রেডেনশিয়াল বা আসল লেনদেন নয়। পূর্ণ ডকুমেন্টেশন এপিআই পাতায় (/user/api) দেখুন।

রিচার্জ-অনুরোধ (উদাহরণ)

POST /api/recharge
{
  "operator_id": 1,
  "mobile": "01700000000",
  "amount": "100",
  "service": "recharge",
  "idempotency_key": "order-20261109-0001"
}

রিচার্জ-উত্তর — 201 (উদাহরণ)

{
  "success": true,
  "message": "recharge send successful",
  "data": {
    "request_id": 123,
    "txn_id": "SR202611092030001234",
    "kind": "recharge",
    "status": "pending",
    "service": "recharge",
    "operator_name": "Grameenphone",
    "mobile_number": "01700000000",
    "amount": "100",
    "commission_amount": "2.00",
    "points_earned": 0,
    "created_at": "2026-11-09 20:30:00"
  },
  "errors": null
}

স্ট্যাটাস জিজ্ঞাসা — 200 (উদাহরণ)

POST /api/requests/123
{
  "success": true,
  "message": "success",
  "data": {
    "request_id": 123,
    "txn_id": "SR202611092030001234",
    "kind": "recharge",
    "status": "success",
    "service": "recharge",
    "operator_name": "Grameenphone",
    "mobile_number": "01700000000",
    "amount": "100",
    "commission_amount": "2.00",
    "points_earned": 0,
    "created_at": "2026-11-09 20:30:00"
  },
  "errors": null
}

উপরের নম্বর ও আইডি উদাহরণের জন্য দেওয়া — আসল অনুরোধে আপনার নিজের operator_id, মোবাইল নম্বর ও অ্যামাউন্ট ব্যবহার করবেন।

নিরাপত্তা ও সুবিধা

প্রতিটি অনুরোধ যাচাই হয়, প্রতিটি ফলাফল জানানো হয়

এপিআই ব্যবহারের পুরো পথটি নিরাপত্তা ও স্বচ্ছতার ওপর দাঁড়িয়ে — কী থেকে স্ট্যাটাস-জিজ্ঞাসা পর্যন্ত।

এপিআই কী

প্রতিটি অ্যাকাউন্টের নিজের এপিআই কী থাকে। কী দিয়েই অনুরোধ চেনা যায়।

HMAC-স্বাক্ষরিত অনুরোধ

প্রতিটি অনুরোধ HMAC-স্বাক্ষর দিয়ে পাঠাতে হয়। স্বাক্ষর না মিললে অনুরোধ গ্রহণ করা হয় না।

রেট লিমিট

রেট লিমিট অনুরোধের গতি সীমার মধ্যে রাখে, যাতে সিস্টেম স্থিতিশীল থাকে।

একই রিকোয়েস্ট দুবার নয়

প্রতিটি অনুরোধে idempotency_key পাঠাতে হয় — একই কি দিয়ে আবার পাঠালে দুবার রিচার্জ হবে না।

স্যান্ডবক্স টেস্টিং

আসল লেনদেনের আগে এপিআই পাতায় প্রতিটি এন্ডপয়েন্টের নিচের স্যান্ডবক্স-টেস্টারে পরীক্ষা করুন।

ব্যালেন্স ও লেনদেন-হিসাব

এপিআই দিয়ে চালানো রিচার্জের ব্যালেন্স ও লেনদেন-হিসাব আপনার অ্যাকাউন্টেই দেখা যাবে — অ্যাডমিনেও ইউজার-রিকোয়েস্টের মতোই দেখাবে।

প্রশ্নোত্তর

এপিআই নিয়ে যা জানতে চান

শুরু করার আগে এপিআই নিয়ে মনে যে প্রশ্নগুলো আসে, সেগুলোর সংক্ষিপ্ত উত্তর।

এপিআই চালু করে কী নিন, স্যান্ডবক্সে পরীক্ষা করুন, আর আপনার সিস্টেম থেকে রিচার্জ চালান। এপিআই আপনার নিজের অ্যাকাউন্টেই চলে — আলাদা অ্যাকাউন্ট নয়।