ملی ای‌پی‌آی

عدد استعلام چک برگشتی را چطور بخوانیم؟ صفر یعنی چه

عدد صفر در استعلام چک برگشتی یعنی سابقه‌ای ثبت نشده، نه اینکه شخص مطمئن است؛ عدد فقط شمارش است و مبلغ، تاریخ و رفع سوءاثر را نشان نمی‌دهد.

عدد صفر در استعلام چک برگشتی یعنی «در این سامانه سابقه‌ای برای این کد ملی ثبت نشده»، نه «این آدم مطمئن است». این تفاوت کوچک، همان جایی است که بیشتر تصمیم‌های اعتباری اشتباه می‌شود.

استعلام چک برگشتی یک عدد می‌دهد: تعداد چک‌های برگشتی ثبت‌شده برای یک کد ملی. اینکه آن عدد را چطور بخوانیم، مهم‌تر از خود عدد است. این مقاله دربارهٔ خواندن درست آن است. برای ورودی و خروجی، راهنمای استعلام چک برگشتی با کد ملی را ببینید.

عدد یعنی چه و چه نیست

پاسخ سرویس در data فقط یک کلید count دارد. مثلاً {"count": 0}. هیچ مبلغی، تاریخی، بانکی، یا وضعیت رفع سوءاثری در آن نیست. پس از این عدد فقط می‌شود دو چیز فهمید: سابقه‌ای ثبت شده یا نه، و اگر شده، چند فقره.

سه برداشت رایج که از همین عدد درمی‌آید ولی پشتوانه ندارد:

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

صفر، یک و چند: سه دسته در تصمیم

برای تصمیم بشری، سه دسته کافی است و بیش از این ظرافت، دقتی که ندارید را وانمود می‌کند:

  1. صفر. سابقه‌ای ثبت نشده. این پایه‌ترین نشانهٔ مثبت است، نه بیشتر.
  2. یک یا دو. باید پرسید و دید. نه رد خودکار و نه عبور خودکار؛ یک گفتگو با مشتری و شاید گرفتن ضمانت بیشتر.
  3. بیشتر از آن. الگوست، نه اتفاق. احتیاط جدی.

این دسته‌بندی را من پیشنهاد می‌کنم، نه قاعده‌ای از سرویس. آستانه‌های دقیق را براساس خطر خود و مبلغ معامله بچینید. سرویس عدد را می‌دهد؛ تعریف «زیاد» با شماست.

کد ملی چه کسی؟

ورودی دو چیز است: کد ملی ده‌رقمی و نوع شخص (ایرانی یا اتباع خارجی، پیش‌فرض ایرانی). یک نکته که اغلب گم می‌شود: کد ملی کسی را می‌زنید که چک را صادر کرده، نه کسی که چک را می‌آورد. اگر مشتری شما چک شخص ثالث آورده، استعلام روی مشتری شما سابقهٔ آن شخص را نشان نمی‌دهد. برای چک شخص ثالث، باید ابتدا ببینید صادرکننده کیست؛ استعلام چک صیادی نام صادرکننده را می‌دهد، ولی برای گرفتن کد ملی او باید از خود مشتری یا مدارک بخواهید.

خطای برنامه‌نویسی که صفر را ناپدید می‌کند

پاسخ سالم با count: 0 در بسیاری از زبان‌ها falsy است. شرطی مثل if (data.count) «صفر» را با «پاسخ نیامد» یکی می‌کند. دقیقاً کسی که سابقه ندارد را مثل کسی که استعلامش شکست خورده برخورد می‌کنید.

js if (out.ok && typeof out.data.count === 'number') { decide(out.data.count); }

همیشه ابتدا ok را بخوانید، بعد نوع عدد را بررسی کنید.

چه چیزی را کنار این عدد بگذاریم

عدد تنها کافی نیست. سه سیگنال کنارش جواب می‌دهند:

  • سابقهٔ خودتان با این مشتری. اگر قبلاً دو سال معامله کرده‌اید، آن سابقه از هر استعلامی ارزشمندتر است.
  • مبلغ و نوع معامله. برای معاملهٔ کوچک، یک عدد صفر کافی است؛ برای معاملهٔ بزرگ، یک گزارش کامل‌تر لازم می‌شود. تفاوت این دو در مقایسهٔ استعلام چک برگشتی و اعتبارسنجی آمده است.
  • مشخصات خود چکی که در دست دارید. بررسی کنید که مشخصات روی برگه با ثبت سامانه می‌خواند.

یک سناریوی فرضی

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

  • مشتری الف: عدد صفر. فروش با چک انجام می‌شود، با سقف اعتبار معمول برای مشتری جدید.
  • مشتری ب: عدد یک. فروشنده تماس می‌گیرد، می‌پرسد چه شده، و یا سقف اعتبار را پایین می‌آورد یا پیش‌پرداخت می‌خواهد.
  • مشتری ج: عدد چهار. فروش فقط نقدی.

این جدول واقعی نیست و از هیچ شرکتی نقل نشده؛ فقط نشان می‌دهد عدد در عمل به سه رفتار ساده می‌رسد، و تصمیم نهایی همیشه شرط‌های دیگر هم دارد.

هر چند وقت یک‌بار دوباره بپرسیم

عدد امروز با عدد شش ماه بعد فرق می‌کند. برای مشتری ثابت، استعلام را هنگام افزایش سقف اعتبار یا پیش از یک سفارش بزرگ‌تر از معمول تکرار کنید، نه هر ماه به‌صورت مکانیکی. هر استعلام هزینه دارد، پس تکرار بی‌هدف همان‌قدر بد است که هرگز تکرار نکردن. در پاسخ، فیلد source نشان می‌دهد نتیجه تازه گرفته شده یا از کش آمده؛ اگر stale درست باشد، یعنی سرویس مرجع در دسترس نبوده و آخرین پاسخ معتبر برگشته است.

نمونهٔ فراخوان

bash curl -X POST 'https://<دامنه>/api/v1/bounced-check/' \ -H 'Authorization: Bearer melli_live_…' \ -H 'Content-Type: application/json' \ -d '{"nationalCode": "0013542419", "nationalityType": 1}'

فیلد nationalityType اگر نفرستید ایرانی در نظر گرفته می‌شود. کد ملی نمونه صرفاً مثال ساختاری است.

پرسش‌هایی که مشتری می‌پرسد

وقتی با عدد تصمیم می‌گیرید، مشتری هم سؤال می‌کند. چند جواب آماده:

«چرا استعلام گرفتید؟» چون پرداخت با چک اعتبار می‌دهد و پیش از دادن اعتبار، بررسی سابقه رایج است. صادقانه و کوتاه بگویید.

«عدد من چند بود؟» اگر شرکت شما سیاست افشا دارد، همان را بگویید؛ در غیر این صورت بگویید که یک عدد کلی دیدید و جزئیاتش را در دست ندارید. هیچ جزئیات اضافه‌ای نیست که بدهید، چون سرویس مبلغ و تاریخ نمی‌دهد.

«من چک را رفع سوءاثر کرده‌ام.» سرویس این را تفکیک نمی‌کند، پس شما هم نمی‌توانید از آن عدد نتیجه بگیرید. گواهی رفع سوءاثر را از مشتری بخواهید و خودتان بررسی کنید.

مهم این است که مشتری فکر نکند با یک عدد قضاوت شده است. عدد را نقطهٔ شروع گفتگو بدانید.

تفاوت با چک‌های دیگری که دست شماست

بین دو چیز فرق بگذارید. «این مشتری قبلاً چک برگردانده؟» پرسش این استعلام است. «این چک مشخص معتبر است؟» پرسش استعلام چک صیادی است. یک مشتری بدون سابقهٔ برگشتی ممکن است چک جعلی بیاورد و مشتری با سابقه ممکن است چک سالم بیاورد؛ پس این دو را جایگزین هم نکنید.

آنچه این سرویس نمی‌کند

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

یک نکته دربارهٔ استفاده از داده

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

در یک نگاه

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

فراخوان و فیلدهای وب‌سرویس چک برگشتی در صفحهٔ خودش آمده است.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API استعلام چک برگشتی

سابقه چک برگشتی یک شخص یا شرکت.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

هنوز پرسشی ثبت نشده، اولین نفر باشید.