استعلام قبوض با جزئیات

کار این API چیست استعلام جزئیات یک قبض خدماتی (آب، برق، برق پشتیبان، گاز) با گرفتن نوع قبض و شناسه مربوط به آن؛ خروجی برای نمایش بدهی و آماده‌سازی پرداخت استفاده می‌شود. متود این API چیست GET ورودی این API چیست type (اجباری): نوع قبض Water → آب Electricity → برق Electricity-support → برق پشتیبان Gas → گاز parameter (اجباری): شناسه استعلام؛ معنی‌اش بسته به type عوض می‌شود آب / برق / برق پشتیبان → شناسه قبض گاز → شماره اشتراک trackId (اختیاری): شناسه پیگیری درخواست؛ برای لاگ و رهگیری سمت خودتان خروجی این API چیست معمولاً اطلاعات قبض به‌همراه جزئیات برمی‌گردد؛ مهم‌ترین موارد رایج: Amount: مبلغ قابل پرداخت / بدهی BillId: شناسه قبض PayId: شناسه پرداخت Date (در صورت وجود): تاریخ مربوط به قبض / مهلت سایر فیلدهای جزئیات (بسته به نوع قبض؛ مثل اطلاعات دوره یا مشخصات قبض) وضعیت پاسخ هم معمولاً با کد موفقیت/خطا و وضعیت انجام درخواست همراه است. این API در چه جاهایی کاربرد دارد اپ/سایت پرداخت قبض کیف پول و سوپراپ‌هایی که قبض آب/برق/گاز می‌گیرند پنل سازمانی برای استعلام بدهی قبل از پرداخت CRM / پشتیبانی مشتری برای چک‌کردن وضعیت قبض گام قبل از فراخوانی API پرداخت قبض (دریافت BillId و PayId) نکات کلیدی برای استفاده‌کننده مقدار parameter را با type هماهنگ بفرستید؛ برای گاز شماره اشتراک است، نه لزوماً شناسه قبض. فقط همین ۴ نوع قبض پشتیبانی می‌شود (Water, Electricity, Electricity-support, Gas). این سرویس برای استعلام با جزئیات است؛ خود پرداخت جدا است و بعد از گرفتن شناسه قبض/پرداخت انجام می‌شود. اگر شناسه اشتباه باشد یا بدهی وجود نداشته باشد، پاسخ خطا یا بدون مبلغ معتبر برمی‌گردد؛ قبل از نمایش به کاربر، مبلغ و شناسه‌ها را اعتبارسنجی کنید.