یک API برای استعلام هویتی، بانکی و خدماتی

استعلام قابل اعتماد،
با هزینهٔ شفاف برای هر درخواست

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

  • محیط آزمایشی جدا، با پاسخ‌های برچسب‌دار mock
  • تعرفهٔ اختصاصی برای هر حساب و هر سرویس
  • رسید شارژ، صورت‌حساب مصرف و گردش کیف پول
iban-inquiry · sandbox
POST /v1/services/iban-inquiry/execute
Authorization: Bearer zh_test_••••••••
Idempotency-Key: order-1042-iban

{ "input": { "iban": "IR771700000000000000000001" } }
response200 OK
{
  "requestId": "sreq_…",
  "status": "SUCCEEDED",
  "billing": {
    "status": "CHARGED",
    "amountRial": "30000",
    "currency": "IRR"
  },
  "mock": true
}

نمونهٔ ساختار درخواست در محیط آزمایشی. مبلغ از تعرفهٔ فعلی همین سرویس خوانده شده است.

مسیر شروع

از ثبت‌نام تا اولین فراخوانی

پنل و API یک مسیر اجرا، قیمت‌گذاری و صورت‌حساب مشترک دارند؛ هر کاری در پنل می‌کنید با کلید هم شدنی است.

ثبت‌نام و احراز

تأیید موبایل، انتخاب حساب حقیقی یا حقوقی و ارسال اطلاعات برای بررسی.

شارژ کیف پول

پرداخت از درگاه و تأیید سمت سرور. موجودی برای پنل و همهٔ کلیدها یکی است.

دریافت کلید API

کلید آزمایشی برای شروع، کلید عملیاتی پس از تأیید حساب و دسترسی سرویس.

فراخوانی و تسویه

مبلغ پیش از فراخوانی رزرو و پس از نتیجه، طبق سیاست سرویس تسویه می‌شود.

شفافیت مالی

هر ریال، قابل ردگیری

کیف پول در پایگاه دادهٔ اصلی و با دفترکل دوطرفه نگه داشته می‌شود، نه در حافظهٔ موقت.

قیمت پیش از اجرا قطعی است

تعرفهٔ مؤثر حساب، پیش‌فرض یا قرارداد اختصاصی، روی خود درخواست ثبت می‌شود و تغییر بعدی تعرفه آن را عوض نمی‌کند.

تکرار، کسر دوباره ندارد

با Idempotency-Key یکسان و ورودی یکسان همان نتیجه برمی‌گردد. ورودی متفاوت با همان کلید رد می‌شود.

خطای فنی هزینه ندارد

ورودی نامعتبر و محدودیت نرخ رایگان است. خطای قطعی تأمین‌کننده رزرو را آزاد می‌کند و نتیجهٔ نامعلوم تا تعیین تکلیف رزرو می‌ماند.

دفترکل دوطرفه و تغییرناپذیر

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

چرخهٔ مالی یک درخواست

نمونهٔ توضیحی
رزرو از موجودی قابل استفادهپیش از فراخوانی تأمین‌کننده
۳۰٬۰۰۰ ریال
فراخوانی تأمین‌کنندهبیرون از تراکنش پایگاه داده
—
پاسخ معتبر: کسر قطعیمثبت یا منفیِ معتبر
۳۰٬۰۰۰ ریال
خطای فنی: آزادسازیمبلغ به موجودی برمی‌گردد
۰ ریال

مبلغ نمونه از تعرفهٔ فعلی استعلام شبا آمده است.

برای توسعه‌دهندگان

یک قرارداد پاسخ برای همهٔ سرویس‌ها

پاسخ همهٔ سرویس‌ها یک شکل دارد. نتیجهٔ منفی معتبر از خرابی فنی جداست و اطلاعات داخلی تأمین‌کننده در پاسخ برنمی‌گردد.

  • شناسهٔ پایدار requestId برای ردگیری و پشتیبانی
  • کلید Idempotency-Key برای تکرار امن
  • کلیدهای جدا برای sandbox و production
نمونه‌کد و راهنما
node.js
const res = await fetch(url, {
  method: "POST",
  headers: {
    authorization: `Bearer ${key}`,
    "idempotency-key": crypto.randomUUID(),
  },
  body: JSON.stringify({ input }),
});

// status: SUCCEEDED | NEGATIVE | FAILED | UNKNOWN

اولین فراخوانی را در محیط آزمایشی بزنید

ثبت‌نام با شمارهٔ موبایل شروع می‌شود. محیط عملیاتی پس از بررسی اطلاعات حساب باز می‌شود.