ثبتنام و احراز
تأیید موبایل، انتخاب حساب حقیقی یا حقوقی و ارسال اطلاعات برای بررسی.
حساب حقیقی یا حقوقی بسازید، کیف پول را شارژ کنید و سرویسها را از پنل یا API فراخوانی کنید. مبلغ هر درخواست پیش از اجرا مشخص است و فقط بابت پاسخ معتبر کسر میشود.
POST /v1/services/iban-inquiry/execute Authorization: Bearer zh_test_•••••••• Idempotency-Key: order-1042-iban { "input": { "iban": "IR771700000000000000000001" } }
{
"requestId": "sreq_…",
"status": "SUCCEEDED",
"billing": {
"status": "CHARGED",
"amountRial": "30000",
"currency": "IRR"
},
"mock": true
}نمونهٔ ساختار درخواست در محیط آزمایشی. مبلغ از تعرفهٔ فعلی همین سرویس خوانده شده است.
قیمت هر کارت مستقیم از تعرفهٔ پیشفرض فعال خوانده میشود؛ همان منبعی که موقع کسر هزینه استفاده میشود.
بررسی تعلق شماره موبایل به کد ملی، با تفکیک عدم تطابق از خطای فنی.
بررسی ساختار شبا و بازگرداندن وضعیت آزمایشی حساب.
بررسی شناسه ملی و بازگرداندن شناسنامه آزمایشی شخص حقوقی.
پنل و API یک مسیر اجرا، قیمتگذاری و صورتحساب مشترک دارند؛ هر کاری در پنل میکنید با کلید هم شدنی است.
تأیید موبایل، انتخاب حساب حقیقی یا حقوقی و ارسال اطلاعات برای بررسی.
پرداخت از درگاه و تأیید سمت سرور. موجودی برای پنل و همهٔ کلیدها یکی است.
کلید آزمایشی برای شروع، کلید عملیاتی پس از تأیید حساب و دسترسی سرویس.
مبلغ پیش از فراخوانی رزرو و پس از نتیجه، طبق سیاست سرویس تسویه میشود.
کیف پول در پایگاه دادهٔ اصلی و با دفترکل دوطرفه نگه داشته میشود، نه در حافظهٔ موقت.
تعرفهٔ مؤثر حساب، پیشفرض یا قرارداد اختصاصی، روی خود درخواست ثبت میشود و تغییر بعدی تعرفه آن را عوض نمیکند.
با Idempotency-Key یکسان و ورودی یکسان همان نتیجه برمیگردد. ورودی متفاوت با همان کلید رد میشود.
ورودی نامعتبر و محدودیت نرخ رایگان است. خطای قطعی تأمینکننده رزرو را آزاد میکند و نتیجهٔ نامعلوم تا تعیین تکلیف رزرو میماند.
هر شارژ، رزرو و کسر یک سند متوازن دارد. اصلاح فقط با سند جبرانی انجام میشود.
مبلغ نمونه از تعرفهٔ فعلی استعلام شبا آمده است.
پاسخ همهٔ سرویسها یک شکل دارد. نتیجهٔ منفی معتبر از خرابی فنی جداست و اطلاعات داخلی تأمینکننده در پاسخ برنمیگردد.
requestId برای ردگیری و پشتیبانیIdempotency-Key برای تکرار امنsandbox و productionconst res = await fetch(url, { method: "POST", headers: { authorization: `Bearer ${key}`, "idempotency-key": crypto.randomUUID(), }, body: JSON.stringify({ input }), }); // status: SUCCEEDED | NEGATIVE | FAILED | UNKNOWN
ثبتنام با شمارهٔ موبایل شروع میشود. محیط عملیاتی پس از بررسی اطلاعات حساب باز میشود.