سرویس «استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست» در دسته استعلام قبض فینوتک، نوع قبض و شناسه مربوط به آن را میگیرد و یک شناسه درخواست همراه وضعیت اولیه استعلام برمیگرداند. این مرحله نتیجه قبض را نمیدهد؛ نتیجه در مرحله دوم، دریافت نتیجه، با همان شناسه درخواست خوانده میشود.
استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست چه مشکلی را حل میکند؟
در استعلام همگام، درخواست کاربر تا رسیدن پاسخ منتظر میماند؛ اگر پاسخ دیر برسد، صفحه قفل میشود، تایماوت سمت شما رخ میدهد و کاربر دوباره دکمه را میزند. در استعلام گروهی — مثل بهروزرسانی بدهی فهرستی از مشترکان یا مکانها — این الگو بدتر هم میشود، چون یک درخواست کند، کل صف پردازش شما را نگه میدارد.
الگوی ناهمگام این وابستگی را میشکند. در این مرحله اطلاعات قبض را ثبت میکنید و بیدرنگ شناسه درخواست و وضعیت فعلی استعلام را میگیرید؛ پردازش در پسزمینه ادامه پیدا میکند و شما بدون معطلکردن کاربر، کار را به مرحله دریافت نتیجه واگذار میکنید. تصمیمی که این خروجی تغذیه میکند این است: درخواست پذیرفته شد یا نه، و با کدام شناسه باید سراغ نتیجه رفت.
کاربردهای استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
- بهروزرسانی گروهی بدهی مشترکان — کیف پول یا سوپراپ، برای فهرستی از قبضهای ذخیرهشده کاربران، درخواستها را پشت سر هم ثبت میکند و نتیجهها را بعداً جمع میکند.
- کارهای زمانبندیشده شبانه — تیم فنی در بازه کمترافیک، درخواست استعلام قبوض شعب و انبارها را ثبت میکند تا داشبورد مالی صبح روز بعد آماده باشد.
- جریانهای کاربری بدون انتظار — اپلیکیشن پرداخت درخواست را ثبت میکند، به کاربر پیام «در حال بررسی» نشان میدهد و صفحه را قفل نمیکند.
- سامانههای صف و کارگزار پیام — پلتفرمهایی که کارها را در صف پردازش میکنند، شناسه درخواست را بهعنوان کلید کار در صف نگه میدارند.
- یکپارچهسازی با سامانههای سازمانی کند — وقتی سمت شما محدودیت زمان پاسخگویی دارد، ثبت درخواست و خواندن بعدی نتیجه، جریان را پایدار میکند.
مزایای استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
- پاسخ سریع در همان درخواست — بدون انتظار برای نتیجه استعلام، شناسه درخواست و وضعیت اولیه را میگیرید.
- مقاومبودن در برابر تایماوت — چون نتیجه در مرحله جداگانه خوانده میشود، طولانیشدن پردازش، درخواست کاربر را قطع نمیکند.
- شناسه پیگیری برای هر استعلام — شناسه درخواست، کلید روشنی برای رهگیری، لاگ و رسیدگی به اختلاف میسازد.
- همان دامنه گسترده انواع قبض — آب، برق، برق پشتیبان، گاز بر اساس شماره اشتراک یا شماره قبض، تلفن ثابت و تلفن همراه در دو حالت پایان دوره و بروز.
- مناسب پردازش انبوه — الگوی ثبت و سپس خواندن نتیجه، با معماری صف و کار پسزمینه سازگار است.
چه چیزی از استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
- ۱. گرفتن توکن — با اسکوپ
billing:billing-inquiry-request:postتوکن Client Credential بگیرید. - ۲. ثبت درخواست — نوع قبض و مقدار متناظر آن را همراه
trackIdبفرستید. - ۳. ذخیره شناسه درخواست — شناسه درخواست و وضعیت بازگشتی را در پایگاه داده خود کنار شناسه کاربر یا مکان ثبت کنید.
- ۴. رفتن به مرحله دوم — نتیجه را از استعلام قبض ناهمگام (مرحله ۲) — دریافت نتیجه با همان شناسه درخواست بخوانید.
- ۵. اعمال قاعده کسبوکاری — پس از دریافت نتیجه، مبلغ را به کاربر نشان دهید یا وارد صف تسویه خودتان کنید.
نحوه شروع استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: billing:billing-inquiry-request:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
- این مرحله فقط درخواست را ثبت میکند؛ نه اطلاعات قبض را برمیگرداند و نه پرداختی انجام میدهد.
- شناسه درخواست را از دست ندهید؛ بدون آن نمیتوانید نتیجه را در مرحله دوم بخوانید.
- ارسال
trackIdدر این سرویس اجباری است: حداکثر ۴۰ کاراکتر حرف و عدد، و پیشنهاد میشود UUID باشد. - معنای مقدار ورودی به نوع قبض وابسته است: شناسه قبض برای آب و برق، شماره اشتراک یا شماره قبض برای گاز، شماره تلفن با کد برای تلفن ثابت و شماره موبایل برای تلفن همراه.
- پوشش آب، برق و گاز سراسری است.
- وضعیت بازگشتی در این مرحله وضعیت شروع کار است، نه نتیجه نهایی؛ منطق محصول خود را بر پایه وضعیت مرحله دوم بنویسید.
سوالات متداول استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست چیست؟
سرویسی است که اطلاعات قبض را دریافت میکند و در پاسخ، شناسه درخواست و وضعیت فعلی استعلام را برمیگرداند تا نتیجه در مرحله بعد با همان شناسه خوانده شود.
تفاوت این سرویس با مرحله دوم چیست؟
این مرحله درخواست را ثبت و شناسه آن را صادر میکند؛ اطلاعات قبض در مرحله ۲ — دریافت نتیجه برگردانده میشود.
چه زمانی بهتر است از مسیر ناهمگام استفاده کنم؟
وقتی نمیخواهید درخواست کاربر منتظر پردازش بماند یا حجم استعلامها زیاد است و کارها را در صف پسزمینه اجرا میکنید؛ برای یک استعلام تکمرحلهای، استعلام قبض سادهتر است.
آیا این سرویس قبض را پرداخت میکند؟
خیر. کل این دسته فقط استعلام است و پرداخت قبض در آن انجام نمیشود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست
مشاهده مستندات فنی «استعلام قبض ناهمگام (مرحله ۱) — ثبت درخواست» — endpoint، پارامترها، نمونه درخواست و پاسخ.