انجام عملیات بانکی سریع و امن
اضافه شدن خدمات پرتقاضا به نرمافزار
حفاظت از حریم خصوصی کاربران
افتتاح حساب هوشمند، بدون مراجعه به شعبه
صرفهجویی در زمان با حذف اطلاعات غیر ضروری
استعلام قبض قبل از پرداخت؛ از کدام سرویس شروع کنید
استعلام قبض قبل از پرداخت یعنی مبلغ، مهلت، شناسه قبض و شناسه پرداخت را از API بگیرید و پرداخت را در درگاه خودتان انجام دهید. دسته استعلام قبض فینوتک پنج سرویس دارد. سه سرویس پاسخ را در همان فراخوانی می‌دهند و دو سرویس یک مسیر ناهمگام دومرحله‌ای می‌سازند. تسویه داخل همین فراخوانی انجام نمی‌شود.
استعلام قبض قبل از پرداخت چیست؟
استعلام قبض قبل از پرداخت، خواندن بدهی همان لحظه است. نوع قبض و شناسه متناسب با آن را می‌فرستید و مبلغ، شناسه قبض، شناسه پرداخت و مهلت پرداخت را می‌گیرید. شناسه پرداخت ورودی درگاه خودتان است. پاسخ، تصویر یک لحظه است؛ اگر بین نمایش مبلغ و تسویه فاصله افتاد، استعلام را دوباره بگیرید.
چه وقت دسته استعلام قبض را باز کنید؟
دسته استعلام قبض را وقتی باز کنید که سؤال پرونده مبلغ و مهلت یک قبض خدماتی است: آب، برق، گاز، تلفن ثابت یا تلفن همراه. هویت صاحب خط، سابقه چک و واریز به شبا در دسته‌های دیگر جواب داده میشوند.
چهار شروع رایج پیش از پرداخت:
- رقم و مهلت را می‌خواهید، از جمله برای تلفن: استعلام قبض.
- صفحه باید ریز قبض آب، برق یا گاز را هم نشان دهد: استعلام قبوض با جزئیات.
- سابقه دوره‌های قبل برق یا گاز لازم است: استعلام تاریخچه قبض.
- صف طولانی است یا صفحه نباید منتظر پاسخ بماند: ثبت درخواست استعلام قبض و بعد دریافت نتیجه استعلام قبض.
از کدام سرویس شروع کنید؟
برای نمایش مبلغ درست پیش از پرداخت، از استعلام قبض شروع کنید. این سرویس آب، برق، گاز، تلفن ثابت و تلفن همراه را در یک الگو می‌پوشاند. شناسه را متناسب با نوع قبض بفرستید: شناسه قبض برای آب و برق، اشتراک یا شماره قبض برای گاز، شماره با کد شهر برای تلفن ثابت، و شماره موبایل برای همراه.
قبض تلفن را می‌توان به‌صورت پایان دوره یا بدهی تا همین لحظه گرفت. برای بعضی اپراتورهای همراه یک ورودی دوم هم لازم است؛ شکل آن در مستندات فنی همان سرویس آمده است.
اگر کاربر یا کارشناس باید علت رقم را ببیند، استعلام قبوض با جزئیات مبلغ، مهلت و در صورت وجود جزئیات قبض را برای آب، برق و گاز برمی‌گرداند. تلفن ثابت و همراه در این سرویس پوشش داده نمی‌شود.
اگر سؤال تحویل ملک، بودجه شعبه یا اعتراض به دوره‌های قبل است، استعلام تاریخچه قبض فهرست سابقه برق یا گاز را می‌دهد. برای برق شناسه قبض و برای گاز شماره اشتراک می‌فرستید. این فهرست، بدهی لحظه‌ای آب یا تلفن را برنمی‌گرداند.
مسیر همگام و ناهمگام چه فرقی دارد؟
مسیر همگام مبلغ، شناسه قبض، شناسه پرداخت و مهلت را در همان فراخوانی برمی‌گرداند و برای یک کاربر منتظر کافی است. مسیر ناهمگام را وقتی انتخاب کنید که انتظار، صفحه یا صف را قفل می‌کند. آنجا اول شناسه درخواست می‌گیرید و مبلغ را فقط بعد از وضعیت موفق می‌خوانید.
در مرحله اول نوع قبض و شناسه ثبت می‌شود و شناسه درخواست به‌همراه وضعیت اولیه برمی‌گردد؛ مبلغ در این پاسخ نیست. در مرحله دوم با همان شناسه می‌خوانید که کار در صف پردازش است، موفق شده، یا ناموفق بسته شده. به‌روزرسانی گروهی، کار شبانه، و محدودیت زمان پاسخ سمت شما سه مورد رایج این مسیرند.
ترتیب فراخوانی قبل از پرداخت چیست؟
ترتیب را از توکن تا درگاه خودتان ثابت نگه دارید تا مبلغی که کاربر می‌بیند با شناسه‌ای که به پرداخت می‌رود یکی باشد. اول توکن، بعد انتخاب سرویس، بعد شناسه متناسب، و در پایان پرداخت بیرون از این API.
- کلاینت را بسازید و توکن Client Credential بگیرید. هر پنج سرویس این دسته با همین رویکرد فراخوانی میشوند و رضایت پیامکی مشترک لازم نیست. گرفتن توکن در راهنمای شروع و معنای OAuth در OAuth چیست؟ آمده است.
- سرویس را از روی سؤال انتخاب کنید: مبلغ جاری، جزئیات، سابقه، یا صف ناهمگام.
- نوع قبض، شناسه متناسب با همان نوع، و یک
trackIdیکتا بفرستید. - در مسیر همگام مبلغ، شناسه قبض، شناسه پرداخت و مهلت را به کاربر نشان دهید.
- در مسیر ناهمگام شناسه درخواست را نگه دارید و دریافت نتیجه را تا خروج از صف تکرار کنید.
- پرداخت را با شناسه قبض و شناسه پرداخت در درگاه خودتان انجام دهید.
- مبلغ را همراه زمان استعلام ذخیره کنید و پیش از نمایش دوباره، استعلام تازه بگیرید.
کدام پرسش به کدام سرویس می‌خورد؟
| پرسش قبل از پرداخت | سرویس | تصمیمی که خروجی می‌سازد |
|---|---|---|
| مبلغ و مهلت، شامل تلفن | استعلام قبض | نمایش رقم و ساخت پرداخت در درگاه خودتان |
| ریز قبض آب، برق یا گاز | استعلام قبوض با جزئیات | توضیح رقم برای کاربر یا پرونده هزینه |
| سابقه برق یا گاز | استعلام تاریخچه قبض | تحویل ملک، بودجه، یا پاسخ به دوره قبل |
| حجم بالا، بدون انتظار | ثبت درخواست، سپس دریافت نتیجه | صف پردازش؛ مبلغ فقط پس از وضعیت موفق |
اشتباه رایج این است که شناسه پرداخت را به‌جای انجام‌شدن پرداخت داخل همین API حساب کنید. اشتباه دوم، گرفتن تاریخچه وقتی صفحه بدهی همین دوره را می‌خواهد. اشتباه سوم، فرستادن شناسه نامتناسب با نوع قبض؛ ورودی گاز و برق یکی نیست.
این دسته چه کاری انجام نمی‌دهد؟
کار این دسته برگرداندن داده قبض است. پرداخت، صدور رسید و ابطال قبض در درگاه و سامانه خودتان می‌ماند. خلافی خودرو هم شناسه قبض دارد، ولی سؤال آن وسیله نقلیه است و در استعلام خودرو قبل از معامله دست‌دوم جدا آمده است. بار تسهیلات و چک برگشتی در تسهیلات و اعتبارسنجی خوانده می‌شود.
تصمیم نشان‌دادن دکمه پرداخت، یادآوری مهلت، یا ارجاع به پشتیبانی با منطق محصول شماست. trackId و زمان فراخوانی را کنار پاسخ نگه دارید تا مغایرت بعدی قابل پیگیری باشد.
از کدام صفحه شروع کنید؟
برای این جریان از صفحه استعلام قبض شروع کنید؛ مرز پنج سرویس و نقطه شروع هر سؤال آنجا جمع شده است. نقشه بقیه دسته‌ها در فهرست سرویس‌ها است. ورودی و نمونه پاسخ هر API در صفحه همان سرویس و سپس در مستندات فنی آمده است.
سوالات متداول
استعلام قبض قبل از پرداخت یعنی API خودش قبض را پرداخت می‌کند؟
استعلام قبض قبل از پرداخت مبلغ، مهلت، شناسه قبض و شناسه پرداخت را برمی‌گرداند تا درگاه خودتان تسویه را انجام دهد. پنج سرویس این دسته فقط داده قبض را می‌خوانند. رسید و ابطال قبض داخل همین فراخوانی نیست. اگر بین نمایش مبلغ و پرداخت فاصله افتاد، استعلام را تازه کنید چون رقم با گذشت زمان عوض می‌شود.
برای تلفن همراه قبل از پرداخت از کدام سرویس شروع کنم؟
برای تلفن همراه از استعلام قبض شروع کنید. تلفن ثابت و همراه در همین سرویس و در مسیر ناهمگام پوشش داده میشوند. جزئیات و تاریخچه، تلفن را برنمی‌گردانند. شماره موبایل را بفرستید؛ برای بعضی اپراتورها یک ورودی دوم هم لازم است. بدهی را می‌توان پایان دوره یا تا همین لحظه گرفت.
استعلام قبوض با جزئیات چه فرقی با استعلام قبض دارد؟
استعلام قبض دامنه آب، برق، گاز و تلفن را دارد و مبلغ، شناسه قبض، شناسه پرداخت و مهلت را می‌دهد. استعلام قبوض با جزئیات فقط آب، برق و گاز است و در صورت وجود، ریز قبض را هم کنار مبلغ برمی‌گرداند. برای رقم پرداخت سرویس اول کافی است. برای توضیح علت رقم، سرویس جزئیات را صدا بزنید.
تاریخچه قبض همان بدهی قابل پرداخت الان است؟
استعلام تاریخچه قبض فهرست سابقه برق یا گاز است و برای تحویل ملک، بودجه شعبه، یا پاسخ به دوره‌های قبل به کار می‌آید. بدهی جاری آب، تلفن، یا همین دوره را از استعلام قبض بگیرید. در تاریخچه، برای برق شناسه قبض و برای گاز شماره اشتراک فرستاده می‌شود. این فهرست دستور پرداخت نمی‌سازد.
مسیر ناهمگام را کی به‌جای استعلام همگام انتخاب کنم؟
مسیر ناهمگام را وقتی انتخاب کنید که یک درخواست کند نباید صفحه یا صف شما را نگه دارد: به‌روزرسانی گروهی، کار زمان‌بندی‌شده، یا محدودیت زمان پاسخ. اول درخواست را ثبت می‌کنید و شناسه درخواست می‌گیرید. مبلغ را فقط بعد از وضعیت موفق در دریافت نتیجه برمی‌دارید. تا وقتی وضعیت در صف پردازش است، نتیجه هنوز آماده نیست.
برای استعلام قبض چه توکنی لازم است؟
هر پنج سرویس با توکن Client Credential فراخوانی میشوند و رضایت پیامکی مشترک لازم نیست. توکن را سمت سرور نگه دارید و در اپلیکیشن یا مرورگر قرار ندهید. ساخت کلاینت و گرفتن توکن در راهنمای شروع فینوتک است. تفاوت این توکن با توکن پیامکی در مقاله OAuth آمده است.