ইন্টিগ্রেশন ধাপ
প্রথমে API কী ও ৫ সংখ্যার মার্চেন্ট পিন দিয়ে ১৫ মিনিটের Access Token নিন। এরপর সেই Bearer টোকেন দিয়ে প্রদানকারী, সেবা, বিল জমা এবং অবস্থা যাচাইয়ের ঠিকানাগুলো ব্যবহার করুন।
Access Token তৈরি
https://smartservices-icps-gov.com/api/v1/gateway/tokenমার্চেন্ট API কী ও ৫ সংখ্যার পিন দিয়ে Access Token নিন। এই টোকেন ১৫ মিনিট কার্যকর থাকে। পরবর্তী বিল API অনুরোধে Authorization: Bearer ... হেডার দিন।
{
"api_key": "nict_live_YOUR_API_KEY",
"pin": "12345"
}{
"success": true,
"data": {
"access_token": "nict_at_xxxxxxxxx",
"token_type": "Bearer",
"expires_in": 900
}
}বিল প্রদানকারীর তালিকা
https://smartservices-icps-gov.com/api/v1/bills/providersসক্রিয় বিল প্রদানকারীর id, নাম এবং লোগো পাওয়া যায়। পরবর্তী ধাপে এই id দিয়ে সেবার তালিকা নিন।
curl "https://smartservices-icps-gov.com/api/v1/bills/providers" \ -H "Accept: application/json" \ -H "Authorization: Bearer nict_at_xxxxxxxxx"
বিল সেবার তালিকা
https://smartservices-icps-gov.com/api/v1/bills/services?provider_id=9প্রতিটি সেবার service_id, ধরন, পরিমাণের তথ্য এবং fields পাওয়া যায়। fields-এ থাকা নামগুলো বিল জমা দেওয়ার সময় details অংশে পাঠান।
{
"success": true,
"data": [
{
"id": 1,
"provider_id": 9,
"name": "পল্লী বিদ্যুৎ প্রিপেইড",
"code": "palli-bidyut-prepaid",
"service_type": "prepaid",
"fields": ["metter_number", "contact_number"]
}
]
}বিল জমা
https://smartservices-icps-gov.com/api/v1/billsনির্বাচিত সেবার id, বিলের পরিমাণ এবং সেবার প্রয়োজনীয় গ্রাহক তথ্য পাঠান। সর্বনিম্ন বিল পেমেন্ট পরিমাণ ৳300। client_reference আপনার নিজস্ব অর্ডার রেফারেন্স হিসেবে সংরক্ষিত হবে।
{
"service_id": 1,
"amount": 300,
"client_reference": "BILL-1001",
"details": {
"metter_number": "1234567890",
"contact_number": "017XXXXXXXX"
}
}{
"success": true,
"message": "বিল পেমেন্ট অনুরোধ সফলভাবে গ্রহণ করা হয়েছে।",
"data": {
"order_number": "B260918001",
"client_reference": "BILL-1001",
"amount": 300,
"pricing_mode": "charge",
"charge_amount": 10,
"commission_amount": 0,
"commission_status": "not_applicable",
"total_debit": 310,
"status": "processing",
"provider_transaction_id": null,
"token_number": null
}
}বিলের অবস্থা যাচাই
https://smartservices-icps-gov.com/api/v1/bills/statusorder_number অথবা client_reference-এর যেকোনো একটি দিয়ে বর্তমান অবস্থা, প্রদানকারীর লেনদেন নম্বর এবং টোকেন নম্বর পাওয়া যায়।
{
"client_reference": "BILL-1001"
}ত্রুটি উত্তর
Access Token ভুল বা মেয়াদোত্তীর্ণ হলে 401, অনুরোধের ফিল্ড ভুল হলে 422 এবং সেবা বা লেনদেন না পাওয়া গেলে 404 HTTP অবস্থা পাওয়া যাবে।
{
"success": false,
"message": "নির্বাচিত বিল সেবা পাওয়া যায়নি অথবা সক্রিয় নয়।"
}