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.transfer_type | 本次出款实际使用的转账类型:bifast 或 rtol。 |
| data.account_number | 该交易使用的银行账号。 |
| data.reason | 交易失败或状态更新的原因(可为 null)。若查询在转账前已过期,则为 Inquiry expired。参见过期查询。 |
| data.service_fee_final | 应用的最终交易费用。 |
| data.similarity_score | 请求中的姓名与银行返回的账户持有人姓名之间的相似度分数,0 到 100。银行未返回姓名时为 0。您的账户未开启姓名校验、银行查询失败,或查询创建于分数记录功能上线之前时为 null。 |
| data.trigger_source | 姓名校验由谁决定:auto_approve(分数达到或高于自动通过阈值)、auto_reject(自动拒绝处于 Enforce 模式且分数低于自动拒绝阈值;reason 为 Rejected)、admin_telegram(审核人通过 Telegram 决定;拒绝时 reason 为 Rejected)、admin_dashboard(查询被扣留期间,审核人在控制台通过或标记为失败;Mark as Failed 时 reason 为 Marked as Failed)。查询仍被扣留(等待审核或触发金额阈值)、未经决定即过期,或 similarity_score 为 null 时为 null。 |
{
"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",
"transfer_type": "bifast",
"account_number": "00000000",
"reason": "",
"service_fee_final": "5500.00"
}
}
{
"status": false,
"data": null,
"message": "Error description"
}
过期查询
在 30 分钟有效期结束时仍处于 pending 或 valid 状态的查询将会过期。系统没有单独的 expired 状态。过期查询将返回:
data.status:faildata.reason:Inquiry expired
请使用 data.reason 区分过期查询与其他失败情况。Webhook 中的对应结果请参见出款过期 Webhook。