API تطبیق کارت، شبا و حساب با کد ملی
تطبیق کارت بانکی، شبا یا شماره حساب با کد ملی از طریق API بازارپی؛ پیش از واریز مطمئن شوید حساب متعلق به خود کاربر است.
وقتی کاربر برای دریافت وجه کارت، شبا یا شماره حساب وارد می‌کند، باید مطمئن شوید آن حساب متعلق به خود اوست. سرویس‌های تطبیق با کد ملی همین را بررسی می‌کنند: تطبیق کارت و کد ملی (تعلق کارت بانکی به کد ملی)، تطبیق شبا و کد ملی (تعلق شبا به کد ملی) و تطبیق حساب و کد ملی (تعلق شماره حساب به کد ملی).
هر سه از یک مسیر /ide/v1/services/matching فراخوانی می‌شوند و نوع تطبیق از روی پارامترها تعیین می‌شود: cardNumber و nationalCode، یا iban و nationalCode، یا bank و depositNumber و nationalCode. هر کدام سرویس و قیمت جداگانه دارد.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار می‌کند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائهدهنده (۵xx) هرگز محاسبه نمیشوند.
کاربردها
- بررسی تعلق حساب تسویه به خود کاربر پیش از واریز
- جلوگیری از برداشت وجه به حساب شخص دیگر
- تکمیل احراز هویت مالی در کنار شاهکار
- بررسی کارت ثبت‌شده برای پرداخت یا بازپرداخت
سرویس‌ها و قیمت
تطبیق کارت و کد ملی
GET | POST /ide/v1/services/matching (cardNumber, nationalCode)تطبیق شبا و کد ملی
GET | POST /ide/v1/services/matching (iban, nationalCode)تطبیق حساب و کد ملی
GET | POST /ide/v1/services/matching (bank, depositNumber, nationalCode)جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
چه نوع تطبیق‌هایی پشتیبانی می‌شود؟
تطبیق کارت بانکی، شبا و شماره حساب با کد ملی؛ هر سه از مسیر /ide/v1/services/matching و با پارامترهای متفاوت.
آیا هر نوع تطبیق جداگانه محاسبه می‌شود؟
بله، هر کدام یک سرویس جداگانه با قیمت مشخص در کاتالوگ است و باید جداگانه درخواست شود.
هزینه این سرویس چطور محاسبه می‌شود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه می‌شوند، خطاهای سمت ارائهدهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.
میتوانم پیش از استفاده واقعی تست کنم؟
بله. با «کلید تست» در پنل، درخواستها همه بررسیهای عادی را میگذرانند اما به ارائهدهنده ارسال نمیشوند؛ پاسخ نمونه با همان ساختار مرجع API برمیگردد و هزینهای کسر نمیشود.