logo

وب سرویس استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست؛

سرویس «استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست» در دسته استعلام قبض فینوتک، نوع قبض و شناسه مربوط به آن را می‌گیرد و یک شناسه درخواست همراه وضعیت اولیه استعلام برمی‌گرداند

سرویس «استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست» در دسته استعلام قبض فینوتک، نوع قبض و شناسه مربوط به آن را می‌گیرد و یک شناسه درخواست همراه وضعیت اولیه استعلام برمی‌گرداند. این مرحله نتیجه قبض را نمی‌دهد؛ نتیجه در مرحله دوم، دریافت نتیجه، با همان شناسه درخواست خوانده می‌شود.

چرا وب سرویس استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست؟

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

  • به‌روزرسانی گروهی بدهی مشترکان — کیف پول یا سوپراپ، برای فهرستی از قبض‌های ذخیره‌شده کاربران، درخواست‌ها را پشت سر هم ثبت می‌کند و نتیجه‌ها را بعداً جمع می‌کند.

تست فوری API استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

1curl --location --request POST 'https://apibeta.finnotech.ir/billing/v2/clients/TestFn/billingInquiryRequest?trackId=trackId' \2--header 'Authorization: Bearer ACCESS_TOKEN' \3--header 'Content-Type: application/json' \4--data-raw '{"type":"Mobile","parameter":"09222223344","secondParameter":"MCI"}'

سوالات متداول

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

این مرحله درخواست را ثبت و شناسه آن را صادر می‌کند؛ اطلاعات قبض در مرحله ۲ — دریافت نتیجه برگردانده می‌شود.

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

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

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

Grant type: client_credentials. جزئیات در راهنمای توکن.

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

Top

آیا می‌خواهید شروع کنید؟

این سرویس فقط به کسب‌وکارها ارائه می‌شود

ما به محقق شدن رؤیای شما کمک می‌کنیم