হোমডকুমেন্টেশন
মোবাইল রিচার্জ API

মোবাইল রিচার্জ API ডকুমেন্টেশন

মার্চেন্ট API কী ও ৫ সংখ্যার রিচার্জ পিন ব্যবহার করে মোবাইল রিচার্জ পাঠান এবং অর্ডার নম্বর অথবা নিজস্ব রেফারেন্স দিয়ে লেনদেনের বর্তমান অবস্থা যাচাই করুন।

মূল ঠিকানা https://smartservices-icps-gov.com/api/v1 সব অনুরোধ HTTPS সংযোগে পাঠান।

ইন্টিগ্রেশন ধাপ

মার্চেন্ট প্যানেল থেকে একটি API কী তৈরি করুন। প্রতিটি রিচার্জ অনুরোধে API কী, মোবাইল নম্বর, পরিমাণ, অপারেটর, অ্যাকাউন্ট ধরন এবং ৫ সংখ্যার রিচার্জ পিন পাঠাতে হবে।

API কী তৈরি রিচার্জ অনুরোধ অর্ডার নম্বর সংরক্ষণ অবস্থা যাচাই

পরিচয় যাচাই

রিচার্জ API-তে প্রতিটি অনুরোধের JSON অংশে api_key পাঠাতে হবে। রিচার্জ তৈরি করার সময় ৫ সংখ্যার pin প্রয়োজন।

নিরাপত্তাAPI কী ও পিন কেবল আপনার সার্ভার থেকে পাঠান। ব্রাউজারের JavaScript বা প্রকাশ্য কোডে এগুলো রাখবেন না।
JSON
{
  "api_key": "nict_live_YOUR_API_KEY",
  "pin": "12345"
}

রিচার্জ তৈরি

POSThttps://smartservices-icps-gov.com/api/v1/recharge

একটি নতুন মোবাইল রিচার্জ অনুরোধ গ্রহণ করার জন্য এই ঠিকানা ব্যবহার করুন। client_reference আপনার নিজস্ব অর্ডার নম্বর হিসেবে ব্যবহার করা যায়। মার্চেন্টের কার্যকর কমিশন রেট অনুরোধের সময় snapshot হয় এবং রিচার্জ সফল হলে cashback_amount স্পেন্ডেবল ওয়ালেটে ক্যাশব্যাক হিসেবে যোগ হয়।

ফিল্ডবিবরণ
mobile১১ সংখ্যার মোবাইল নম্বর; Brilliant Connect-এর সমর্থিত নম্বরও গ্রহণ করা হয়।
amountরিচার্জের পরিমাণ; উদাহরণ: 100।
operatorGP, BL, RB, AT, TT অথবা BRI।
account_typeprepaid, postpaid অথবা Skitto-এর জন্য GP ST।
pinমার্চেন্টের ৫ সংখ্যার রিচার্জ পিন।
client_referenceআপনার সিস্টেমের নিজস্ব রেফারেন্স; ঐচ্ছিক।
অনুরোধ
curl -X POST "https://smartservices-icps-gov.com/api/v1/recharge" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "nict_live_YOUR_API_KEY",
    "mobile": "017XXXXXXXX",
    "amount": 100,
    "operator": "GP",
    "account_type": "prepaid",
    "pin": "12345",
    "client_reference": "ORDER-1001"
  }'
সফল উত্তর
{
  "success": true,
  "message": "মোবাইল রিচার্জ অনুরোধ সফলভাবে গ্রহণ করা হয়েছে।",
  "data": {
    "order_number": "847392615",
    "client_reference": "ORDER-1001",
    "mobile": "017XXXXXXXX",
    "amount": 100,
    "operator": "GP",
    "account_type": "prepaid",
    "status": "processing",
    "status_message": "প্রক্রিয়াধীন আছে।",
    "commission_percent": 1.5,
    "cashback_amount": 1.5,
    "cashback_status": "not_credited",
    "provider_transaction_id": null
  }
}

Skitto রিচার্জ

Skitto নম্বরের জন্য operator হিসেবে GP এবং account_type হিসেবে ঠিক GP ST পাঠাতে হবে।

JSON
{
  "api_key": "nict_live_YOUR_API_KEY",
  "mobile": "017XXXXXXXX",
  "amount": 100,
  "operator": "GP",
  "account_type": "GP ST",
  "pin": "12345"
}

রিচার্জের অবস্থা যাচাই

POSThttps://smartservices-icps-gov.com/api/v1/recharge/status

order_number অথবা client_reference-এর যেকোনো একটি পাঠিয়ে বর্তমান অবস্থা পাওয়া যায়।

processingঅনুরোধ প্রক্রিয়াধীন; সফল না হওয়া পর্যন্ত ক্যাশব্যাক যোগ হয় না।
successরিচার্জ সম্পন্ন হয়েছে।
failedরিচার্জ সম্পন্ন হয়নি।
অর্ডার নম্বর দিয়ে
{
  "api_key": "nict_live_YOUR_API_KEY",
  "order_number": "847392615"
}
নিজস্ব রেফারেন্স দিয়ে
{
  "api_key": "nict_live_YOUR_API_KEY",
  "client_reference": "ORDER-1001"
}

ত্রুটি উত্তর

API কী ভুল হলে 401, অনুরোধের তথ্য ভুল হলে 422 এবং লেনদেন না পাওয়া গেলে 404 HTTP অবস্থা পাওয়া যাবে। উত্তর সবসময় JSON আকারে আসে।

উদাহরণ
{
  "success": false,
  "message": "রিচার্জ PIN সঠিক নয়।"
}