হোমডকুমেন্টেশন
বিল পেমেন্ট API

বিল পেমেন্ট API ডকুমেন্টেশন

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

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

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

প্রথমে API কী ও ৫ সংখ্যার মার্চেন্ট পিন দিয়ে ১৫ মিনিটের Access Token নিন। এরপর সেই Bearer টোকেন দিয়ে প্রদানকারী, সেবা, বিল জমা এবং অবস্থা যাচাইয়ের ঠিকানাগুলো ব্যবহার করুন।

Access Token প্রদানকারী ও সেবা বিল জমা অবস্থা যাচাই

Access Token তৈরি

POSThttps://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
  }
}

বিল প্রদানকারীর তালিকা

GEThttps://smartservices-icps-gov.com/api/v1/bills/providers

সক্রিয় বিল প্রদানকারীর id, নাম এবং লোগো পাওয়া যায়। পরবর্তী ধাপে এই id দিয়ে সেবার তালিকা নিন।

cURL
curl "https://smartservices-icps-gov.com/api/v1/bills/providers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer nict_at_xxxxxxxxx"

বিল সেবার তালিকা

GEThttps://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"]
    }
  ]
}

বিল জমা

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

নির্বাচিত সেবার id, বিলের পরিমাণ এবং সেবার প্রয়োজনীয় গ্রাহক তথ্য পাঠান। সর্বনিম্ন বিল পেমেন্ট পরিমাণ ৳300। client_reference আপনার নিজস্ব অর্ডার রেফারেন্স হিসেবে সংরক্ষিত হবে।

চার্জ / কমিশনমার্চেন্ট-স্পেসিফিক নিয়ম থাকলে সেটি আগে কার্যকর হয়। Fixed charge থাকলে বিল জমার সময় amount + charge কাটা হয়। Fixed commission থাকলে charge কাটা হয় না; কেবল সফল হওয়ার পর commission ক্যাশব্যাক যোগ হয়। স্পেসিফিক নিয়ম না থাকলে Admin-এর default fixed charge কার্যকর হয়।
অনুরোধ
{
  "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
  }
}

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

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

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

processingপ্রক্রিয়াধীন; commission থাকলে এখনো যোগ হয়নি।
successবিল সফল; প্রযোজ্য fixed commission একবার ক্যাশব্যাক হয়েছে।
refundedমূল টাকা ও প্রযোজ্য charge ফেরত দেওয়া হয়েছে।
JSON
{
  "client_reference": "BILL-1001"
}

ত্রুটি উত্তর

Access Token ভুল বা মেয়াদোত্তীর্ণ হলে 401, অনুরোধের ফিল্ড ভুল হলে 422 এবং সেবা বা লেনদেন না পাওয়া গেলে 404 HTTP অবস্থা পাওয়া যাবে।

উদাহরণ
{
  "success": false,
  "message": "নির্বাচিত বিল সেবা পাওয়া যায়নি অথবা সক্রিয় নয়।"
}