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

استعلام چک صیادی

سرویس استعلام چک صیادی API360، امکان بررسی وضعیت اعتبار چک‌های جدید صیادی را برای کسب‌وکارها فراهم می‌کند. با استفاده از این متد، شما می‌توانید با داشتن شناسه ۱۶ رقمی چک و کد ملی ذینفع یا صادرکننده، آخرین وضعیت ثبت و تایید چک را در سامانه مرکزی پیچک (بانک مرکزی) دریافت نمایید. این سرویس برای پلتفرم‌های لندتک و سیستم‌های حسابداری آنلاین طراحی شده است.

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

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

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

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

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

پارامتر	نوع	الزامی	توضیحات
sayadId	String (16)	بله	شناسه ۱۶ رقمی مندرج روی چک صیادی
nationalCode	String (10)	بله	کد ملی استعلام کننده (ذینفع یا صادرکننده)

تعرفه سرویس

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

۵۰۰ تومان

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

{
  "sayadId": "1234567890123456",
  "nationalCode": "0012345678"
}

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

{
  "success": true,
  "data": {
    "status": "REGISTERED",
    "amount": 500000000,
    "dueDate": "1402/10/25",
    "bank": "BANK_MELLI",
    "issuerName": "محمد محمدی",
    "isBlocked": false
  },
  "requestId": "req_88291x"
}

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

{
  "success": false,
  "error": {
    "code": "INVALID_SAYAD_ID",
    "message": "شناسه صیادی نامعتبر است"
  }
}