检查查询状态 · PGSwift Docs

POST /api/check/inquiry

请求

名称	类型	必填	描述
merchant_transaction_id	string	true	商户提供的交易标识符。

{
  "merchant_transaction_id": "INQ12300456"
}

响应

名称	描述
status	请求状态指示器。成功时为 true，失败时为 false。
data.status	当前查询状态：pending（待处理）、valid（已批准，等待转账）、processing（处理中）、success（成功）、fail（失败）
data.merchant_transaction_id	商户提供的交易标识符
data.amount	交易金额，字符串格式，保留两位小数（例如 `"100000.00"`）
data.bank_code	交易使用的银行代码。
data.account_number	该交易使用的银行账号。
data.reason	交易失败或状态更新的原因（可为 null）。若查询在转账前已过期，则为 `Inquiry expired`。参见过期查询。
data.service_fee_final	应用的最终交易费用。

{
    "status": true,
    "data": {
        "status": "success",
        "created_at": "2025-01-01T00:00:00.000000Z",
        "updated_at": "2025-01-01T12:00:00.000000Z",
        "merchant_transaction_id": "INQ12300456",
        "amount": "100000.00",
        "bank_code": "009",
        "account_number": "00000000",
        "reason": "",
        "service_fee_final": "5500.00"
    }
}

{
    "status": false,
    "data": null,
    "message": "Error description"
}

过期查询

在 30 分钟有效期结束时仍处于 pending 或 valid 状态的查询将会过期。系统没有单独的 expired 状态。过期查询将返回：

data.status：fail
data.reason：Inquiry expired

请使用 data.reason 区分过期查询与其他失败情况。Webhook 中的对应结果请参见出款过期 Webhook。