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

استعلام شبا

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

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

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

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

کلید	مقدار	توضیحات
x-api-key	YOUR_API_KEY	کلید اختصاصی دسترسی به سرویس
Content-Type	application/json	فرمت داده‌های ارسالی

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

پارامتر	نوع	الزامی	توضیحات
iban	String	بله	شماره شبا (با شروع IR)
trackId	String	خیر	کد پیگیری دلخواه شما

محدودیت نرخ (Rate Limit)

حداکثر ۱۰ درخواست در دقیقه در طرح پایه

۱۰ در دقیقه

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

{
  "iban": "IR060120000000001234567890",
  "trackId": "INV-1001"
}

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

{
  "success": true,
  "bankName": "بانک ملت",
  "owners": [
    {
      "firstName": "محمد",
      "lastName": "رضایی"
    }
  ],
  "status": "ACTIVE",
  "trackId": "INV-1001"
}

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

{
  "success": false,
  "errorCode": "INVALID_IBAN",
  "message": "فرمت شماره شبا صحیح نیست"
}