خطاهای رایج استعلام چک صیادی
شناسه صیادی ۱۶ رقم است و بیشتر خطاها در همین عدد ریشه دارند. بقیه، پاسخ واقعی استعلام‌اند نه خطای سرویس، و این دو یکی نیستند.
استعلام چک صیادی یک ورودی دارد: شناسه صیادی. بیشتر خطاها هم به همین برمی‌گردند، چون ۱۶ رقم است و از روی برگه تایپ می‌شود.
شناسه صیادی چند رقم است؟
۱۶ رقم. این عدد روی خود برگه چک چاپ شده و با شماره سری و سریال چک فرق دارد.
API پیش از تماس با سامانهٔ مرجع طول را بررسی می‌کند. اگر پاسخ invalid_input با پیام «شناسه صیادی باید ۱۶ رقم باشد» گرفتید، یعنی استعلامی انجام نشده و هزینه‌ای هم کسر نشده است.
خطاهایی که پیش از استعلام گرفته می‌شوند
- تعداد رقم کم یا زیاد است. رایج‌ترین علت: جا افتادن یک رقم هنگام تایپ از روی برگه چک.
- شماره سری یا سریال به‌جای شناسه صیادی وارد شده. این دو عدد کوتاه‌ترند و روی همان برگه چاپ شده‌اند؛ اشتباه‌گرفتنشان رایج است.
- کاراکتر اضافه از کپی آمده. وقتی عدد را از پیامک کپی می‌کنید، گاهی کاراکترهای نامرئی هم همراهش می‌آیند.
فاصله و خط تیره مشکلی ندارند؛ API خودش حذفشان می‌کند. ارقام فارسی هم پذیرفته می‌شوند.
پاسخ‌هایی که خطا نیستند
اگر شناسه از اعتبارسنجی ورودی گذشت، استعلام انجام می‌شود و ممکن است پاسخی برگردد که به نظر «خطا» می‌آید ولی در واقع نتیجه است: چکی با این شناسه پیدا نشد.
این یک پاسخ معتبر است. استعلام کار خودش را انجام داده و جوابش این بوده، پس رسیدش صادر می‌شود.
چه چیزهایی در نتیجه می‌آید
وقتی چک پیدا شود، اینها برمی‌گردد:
- نام صادرکننده چک
- شماره شبای حساب صادرکننده
- شماره سری و شماره سریال
- نوع چک
- تاریخ صدور
- کد شعبه
- تاریخ سررسید
- وضعیت چک‌های برگشتی مرتبط
رنگ چک در نتیجه نیست
این را صریح می‌نویسیم چون پرسش پرتکراری است: پاسخ این سرویس هیچ فیلد رنگی ندارد. اگر دنبال رنگ چک هستید، این استعلام آن را نمی‌دهد.
تاریخ سررسید ممکن است خالی باشد
فیلد تاریخ سررسید می‌تواند بدون مقدار برگردد. خالی‌بودنش نقص پاسخ نیست؛ یعنی برای آن چک تاریخی ثبت نشده.
زنجیره انتقال، استعلام دیگری است
اگر می‌خواهید بدانید چک از چه کسی به چه کسی منتقل شده، آن یک سرویس جداگانه است و ورودی بیشتری می‌خواهد.
اگر خطای ناشناخته دیدید
وقتی پاسخی برگردد که نتوانیم طبقه‌بندی‌اش کنیم، فراخوان بی‌هزینه ثبت می‌شود و مبلغ قفل‌شده به موجودی برمی‌گردد. قاعده‌مان ساده است: بابت نتیجه‌ای که حتی خودمان نمی‌توانیم توضیحش بدهیم، پول نمی‌گیریم.
برای استفادهٔ برنامه‌نویسی از این موضوع، سراغ استعلام چک صیادی بروید و برای ادامهٔ بحث، استعلام چک برگشتی با کد ملی را بخوانید.
وب‌سرویس مرتبط با این راهنما
API استعلام چک صیادی
مشخصات ثبت‌شده چک صیادی را پیش از پذیرش ببینید.
راهنماهای مرتبط
پرسش و تجربه کاربران
اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.
هنوز پرسشی ثبت نشده، اولین نفر باشید.