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

استعلام کارت بانکی

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

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

POST https://api.api360.ir/v1/card/inquiry

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

کلید	مقدار	توضیحات
Authorization	Bearer {API_KEY}	کلید اختصاصی دسترسی به سرویس
Content-Type	application/json	فرمت داده‌های ارسالی

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

پارامتر	نوع	الزامی	توضیحات
cardNumber	String	بله	شماره ۱۶ رقمی کارت بانکی
trackId	String	خیر	شناسه یکتا جهت پیگیری در سیستم مشتری

تعرفه سرویس

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

۵۰۰ تومان

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

{
  "cardNumber": "6037991122334455",
  "trackId": "txn_894210"
}

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

{
  "success": true,
  "data": {
    "bankName": "بانک ملی ایران",
    "cardNumber": "603799******4455",
    "status": "ACTIVE",
    "type": "DEBIT",
    "logo": "https://cdn.api360.ir/banks/melli.png"
  },
  "message": "استعلام با موفقیت انجام شد",
  "trackId": "txn_894210"
}

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

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