API و وب سرویس تطابق کد ملی و شبا

مبلغ تسویه‌ای را تصور کنید که قرار است با پایا به شبای فروشنده برود. اگر شبا را فروشنده تایپ کرده باشد، یک رقم اشتباه یا شبای شخص دیگر هزینهٔ بازگرداندن و گاهی اختلاف حقوقی می‌سازد. این استعلام کد ملی، تاریخ تولد شمسی و شبا را می‌گیرد و در matched می‌گوید حساب پشت این شبا متعلق به همین شخص است یا نه.

شبا شناسهٔ حساب است، نه شناسهٔ کارت. یک حساب می‌تواند چند کارت داشته باشد و همهٔ آنها یک شبا دارند، و برای تسویه‌هایی که به حساب می‌روند همین شناسه مهم است.

شبا را چطور آماده کنیم

شبا را با IR و بیست‌وچهار رقم بفرستید. حروف کوچک و فاصله‌ها پیش از اعتبارسنجی حذف و حروف بزرگ می‌شوند، ولی شبایی که پیش‌وند یا طول درست نداشته باشد یا رقم کنترلش بخواند، با invalid_input برمی‌گردد و هزینه ندارد. تاریخ تولد هم اجباری است.

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

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

با نتیجه چه کنیم

پاسخ مثبت را پیش از ثبت دستور پرداخت بگیرید و کنار شناسهٔ پاسخ بایگانی کنید. نتیجه تا چند روز کش می‌شود و source.cached آن را نشان می‌دهد؛ برای تسویهٔ بزرگ استعلام تازه بگیرید.

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

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