فعال نسخه ۱.۰.۰

استعلام چک‌های در راه

این سرویس به شما امکان می‌دهد تمامی چک‌های صیادی ثبت شده در سامانه مرکزی را که به نام یک کد ملی خاص صادر شده‌اند و هنوز سررسید آن‌ها فرانرسیده است، استعلام کنید. این ابزار برای ارزیابی ریسک اعتباری و مدیریت نقدینگی سازمان‌ها بسیار حیاتی است.

link نقطه اتصال (Endpoint)

POST https://api.api360.ir/v1/check/incoming

هدرهای احراز هویت

کلید	مقدار	توضیحات
Authorization	Bearer {API_KEY}	کلید اختصاصی دسترسی به سرویس

پارامترهای ورودی (Body)

پارامتر	نوع	الزامی	توضیحات
nationalCode	String (10)	بله	کد ملی ۱۰ رقمی صاحب چک

تعرفه سرویس

محاسبه به ازای هر فراخوانی موفق

۱,۰۰۰ تومان

نمونه درخواست JSON

{
  "nationalCode": "0012345678"
}

پاسخ موفق (200 OK)

{
  "success": true,
  "checkCount": 2,
  "items": [
    {
      "sayadId": "123456789012",
      "amount": 500000000,
      "dueDate": "1402/12/25",
      "bankName": "بانک ملت"
    },
    {
      "sayadId": "987654321098",
      "amount": 120000000,
      "dueDate": "1403/01/15",
      "bankName": "بانک ملی"
    }
  ]
}

خطاهای احتمالی

{
  "success": false,
  "errorCode": "INVALID_NATIONAL_CODE",
  "message": "کد ملی وارد شده نامعتبر است."
}