ইন্টিগ্রেশন ধাপ
মার্চেন্ট প্যানেল থেকে একটি API কী তৈরি করুন। প্রতিটি রিচার্জ অনুরোধে API কী, মোবাইল নম্বর, পরিমাণ, অপারেটর, অ্যাকাউন্ট ধরন এবং ৫ সংখ্যার রিচার্জ পিন পাঠাতে হবে।
পরিচয় যাচাই
রিচার্জ API-তে প্রতিটি অনুরোধের JSON অংশে api_key পাঠাতে হবে। রিচার্জ তৈরি করার সময় ৫ সংখ্যার pin প্রয়োজন।
{
"api_key": "nict_live_YOUR_API_KEY",
"pin": "12345"
}রিচার্জ তৈরি
https://smartservices-icps-gov.com/api/v1/rechargeএকটি নতুন মোবাইল রিচার্জ অনুরোধ গ্রহণ করার জন্য এই ঠিকানা ব্যবহার করুন। client_reference আপনার নিজস্ব অর্ডার নম্বর হিসেবে ব্যবহার করা যায়। মার্চেন্টের কার্যকর কমিশন রেট অনুরোধের সময় snapshot হয় এবং রিচার্জ সফল হলে cashback_amount স্পেন্ডেবল ওয়ালেটে ক্যাশব্যাক হিসেবে যোগ হয়।
| ফিল্ড | বিবরণ |
|---|---|
mobile | ১১ সংখ্যার মোবাইল নম্বর; Brilliant Connect-এর সমর্থিত নম্বরও গ্রহণ করা হয়। |
amount | রিচার্জের পরিমাণ; উদাহরণ: 100। |
operator | GP, BL, RB, AT, TT অথবা BRI। |
account_type | prepaid, 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 পাঠাতে হবে।
{
"api_key": "nict_live_YOUR_API_KEY",
"mobile": "017XXXXXXXX",
"amount": 100,
"operator": "GP",
"account_type": "GP ST",
"pin": "12345"
}রিচার্জের অবস্থা যাচাই
https://smartservices-icps-gov.com/api/v1/recharge/statusorder_number অথবা client_reference-এর যেকোনো একটি পাঠিয়ে বর্তমান অবস্থা পাওয়া যায়।
{
"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 সঠিক নয়।"
}