سرویس «استعلام قبض ناهمگام (مرحله ۲) — دریافت نتیجه» در دسته استعلام قبض فینوتک با گرفتن شناسه درخواستی که در مرحله ثبت درخواست صادر شده، وضعیت استعلام و در صورت موفقیت، نتیجه قبض را برمیگرداند. این مرحله جایی است که میفهمید کار در صف است، با موفقیت انجام شده یا با خطا بسته شده است.
در مسیرهای ناهمگام، بزرگترین ریسک، بیخبری است: درخواست ثبت شده اما محصول شما نمیداند بدهی کاربر چقدر است و آیا استعلام به سرانجام رسیده یا نه. تیمها در این حالت به راهحلهای شکننده پناه میبرند؛ مثل تکرار کور درخواست ثبت، نمایش مبلغ قدیمی به کاربر یا رسیدگی دستی به کارهای نیمهتمام. هر سه، هم داده نادرست تولید میکند و هم بار پشتیبانی میسازد.
استعلام قبض ناهمگام (مرحله ۲) — دریافت نتیجه چیست؟
سرویسی است که با دریافت شناسه درخواست مرحله اول، وضعیت استعلام و در صورت موفقیت، نتیجه قبض را برمیگرداند.
تفاوت این سرویس با مرحله ثبت درخواست چیست؟
مرحله ۱ درخواست را ثبت و شناسه آن را صادر میکند؛ این مرحله همان شناسه را میگیرد و وضعیت و نتیجه را برمیگرداند.
وضعیتهای ممکن استعلام چیست؟
درخواست میتواند در صف پردازش باشد، با موفقیت انجام شده باشد یا ناموفق بسته شود. مقادیر دقیق در مستندات فنی آمده است.
هر چند وقت یکبار وضعیت را بخوانم؟
بازه بازخوانی را با توجه به نیاز محصول خود انتخاب کنید و برای آن سقف تکرار بگذارید تا کارهای بیپاسخ به حلقه بیپایان تبدیل نشوند.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.