سرویس های قبض

استعلام قبض ناهمگام (مرحله ۲) — دریافت نتیجه

<!--seo-open-->

سرویس «استعلام قبض ناهمگام (مرحله ۲) — دریافت نتیجه» در دسته استعلام قبض فینوتک. ورودی‌ها و خروجی در مشخصات فنی همین صفحه آمده است. با رویکرد Client Credential قابل فراخوانی است. برای ساخت کلاینت و گرفتن توکن، راهنمای شروع را ببینید.

<!--/seo-open-->

با ورود شناسه درخواست (requestId) از مرحله ثبت درخواست، نتیجه استعلام قبض برگردانده می‌شود.

Scope: billing:billing-inquiry-status:post<br />

Grant type: client_credentials

مراحل فراخوانی

  1. ثبت درخواست استعلام قبض (مرحله ۱)
  2. دریافت نتیجه استعلام (این سرویس)

وضعیت‌های result.status

statusMeaning
PENDINGدرخواست در صف پردازش است
SUCCESSاستعلام با موفقیت انجام شد — فیلد data را بررسی کنید
FAILEDاستعلام ناموفق — فیلد error را بررسی کنید
post/billing/v2/clients/{clientId}/billingInquiryStatus

Request

  • Base URL: https://api.finnotech.ir
  • URL: https://api.finnotech.ir/billing/v2/clients/{clientId}/billingInquiryStatus
  • Auth: HTTP bearer

Path parameters

clientIdstring required

Query parameters

trackIdstring required

Correlation ID (max 40 alphanumeric characters). UUID recommended.

Request body

requestIdstring required

Request ID from the submit step (شناسه دریافتی از مرحله اول)

Example request

{
  "requestId": "e3e9fa28-ed42-42b1-b15a-c55bb0961b92"
}

Response

وضعیت استعلام (ممکن است هنوز در حال پردازش باشد)

responseCodestring

Response code returned by the service

trackIdstring

Correlation ID — echoed from the request or auto-generated

status'DONE' | 'FAILED'

Overall API call status (وضعیت فراخوانی سرویس)

Example response

{
  "result": {
    "data": {
      "amount": "3613000",
      "billId": "9480837904123",
      "payId": "361350182",
      "date": "1405/03/05"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.