পে-ইন অর্ডার অনুসন্ধান (/payin/query)

বিবরণ

মার্চেন্ট পে-ইন অর্ডারের রিয়েল-টাইম স্ট্যাটাস এবং বিস্তারিত তথ্য অনুসন্ধানের জন্য এই এপিআই ব্যবহার করতে পারেন। সাধারণত সময়মতো কলব্যাক না পেলে বা অ্যাকাউন্ট রিকনসিলিয়েশনের জন্য এটি ব্যবহৃত হয়।

---

রিকোয়েস্টের সাধারণ তথ্য

• রিকোয়েস্ট URL: /payin/query
• মেথড (Method): POST
• Content-Type: application/json; charset=utf-8

---

রিকোয়েস্ট হেডার (HTTP Headers)

প্যারামিটার	বাধ্যতামূলক	ধরন (Type)	বিবরণ
merchantNo	হ্যাঁ (Yes)	String	মার্চেন্ট নম্বর
sign	হ্যাঁ (Yes)	String	রিকোয়েস্ট বডির Base64 RSA ডিজিটাল স্বাক্ষর

---

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	বাধ্যতামূলক	ধরন	উদাহরণের মান	বিবরণ
timestamp	হ্যাঁ	Long	1772880200000	মিলিসেকেন্ড টাইমস্ট্যাম্প
merchantOrderNo	হ্যাঁ	String	202603070001	অনুসন্ধানের জন্য মার্চেন্ট অর্ডার নম্বর

রিকোয়েস্ট পেলোড উদাহরণ

{
  "timestamp": 1772880200000,
  "merchantOrderNo": "202603070001"
}

---

রেসপন্স প্যারামিটার

সফল রেসপন্স উদাহরণ

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "2.20",
    "payUrl": "https://gateway.example.com/checkout/876324486452871168",
    "expireTime": "2026-05-05 11:11:11",
    "status": "3",
    "payTime": "2026-09-09 22:22:22",
    "payAccountNo": "01666777888",
    "trxId": "SDIIFKISDL"
  }
}

ব্যর্থ রেসপন্স উদাহরণ

{
  "code": 0,
  "msg": "param merchant error"
}

রেসপন্স ফিল্ডের বিবরণ

ফিল্ডের নাম	বাধ্যতামূলক	ধরন	বিবরণ
code	হ্যাঁ	Integer / String	1 সফল, 0 ব্যর্থ
msg	হ্যাঁ	String	তথ্যের বিবরণ
data	হ্যাঁ	Object	অর্ডারের বিস্তারিত তথ্য অবজেক্ট
data.merchantNo	হ্যাঁ	String	মার্চেন্ট নম্বর
data.merchantOrderNo	হ্যাঁ	String	মার্চেন্ট অর্ডার নম্বর
data.platOrderNo	হ্যাঁ	String	প্ল্যাটফর্ম অর্ডার নম্বর
data.amount	হ্যাঁ	String	অর্ডারের পরিমাণ
data.fee	হ্যাঁ	String	সার্ভিস ফি
data.expireTime	হ্যাঁ	String	পেমেন্টের মেয়াদোত্তীর্ণের সময়
data.payUrl	হ্যাঁ	String	ক্যাশিয়ার পেমেন্ট লিঙ্ক
data.status	হ্যাঁ	String	অর্ডারের অবস্থা: 0: তৈরি করা হয়েছে 1: মেয়াদোত্তীর্ণ 2: ব্যর্থ 3: সফল
data.payTime	না	String	অর্থপ্রদানের সময় (ফরম্যাট: yyyy-MM-dd HH:mm:ss)
data.payAccountNo	না	String	পেমেন্ট অ্যাকাউন্ট নম্বর (Payer account number)
data.trxId	না	String	ই-ওয়ালেট সিস্টেম দ্বারা তৈরি অনন্য ট্রানজ্যাকশন আইডি