زی‌هاب/سرویس‌ها/استعلام شبا

استعلام شبا

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

بانکی

ورودی

  • شماره شبا ibanشبا ایران با ۲۶ نویسه، شامل IR و رقم کنترل IBAN.

خروجی

  • بانک bankNameنام نمایشی آزمایشی.
  • وضعیت accountStatusوضعیت آزمایشی حساب.

نمونهٔ درخواست و شکل پاسخ

نمونهٔ ساختار است و نتیجهٔ یک فراخوانی واقعی نیست.

POST /v1/services/iban-inquiry/execute
Authorization: Bearer zh_test_…
Idempotency-Key: <unique-per-operation>

{
  "input": {
    "iban": "IR771700000000000000000001"
  }
}
{
  "requestId": "sreq_…",
  "status": "SUCCEEDED | NEGATIVE | FAILED | UNKNOWN",
  "data": { … },
  "error": null,
  "billing": { "status": "CHARGED | RELEASED | PENDING_RECONCILIATION", "amountRial": "…", "currency": "IRR" },
  "mock": true
}

خطاها و هزینه

VALIDATION_ERRORورودی از نظر ساختاری نامعتبر است و هزینه‌ای ندارد.بدون هزینه
FORBIDDENحساب یا کلید به این سرویس دسترسی ندارد و هزینه‌ای ندارد.بدون هزینه
RATE_LIMITEDمحدودیت نرخ اعمال شده و هزینه‌ای ندارد.بدون هزینه
INSUFFICIENT_FUNDSموجودی قابل استفاده کافی نیست و رزروی انجام نمی‌شود.بدون هزینه
PROVIDER_ERRORخطای فنی قطعی است و رزرو آزاد می‌شود.بدون هزینه
PROVIDER_TIMEOUTنتیجه نامعلوم است. وجه تا تعیین تکلیف رزرو می‌ماند.بدون هزینه

رفتار محیط آزمایشی: چهار رقم آخر BBAN: 0000 نامعتبرِ معتبر، 1001 خطای فنی، 2002 مهلت نامعلوم.