ورودی
- شماره شبا
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 مهلت نامعلوم.