主题
账户付款交易查询
接口描述
- 商户可以通过查询接口主动查询订单状态。
请求URL
/bk/account/payment/query
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间,13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 否 | string | 32 | 接入方交易流水号(与tradeNo不可同时为空) | OUT00000001 |
| tradeNo | 否 | string | 32 | 支付系统交易流水号(与outTradeNo不可同时为空) | 1854100814175592449 |
- 注:outTradeNo与tradeNo不能同时为空
公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间,13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 是 | string | 32 | 接入方交易流水号 | 123456789 |
| tradeNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
| merchantNo | 是 | string | 32 | 商户编号 | XS241113000204 |
| amount | 是 | string | 金额(单位分) | 100 | |
| tradeFee | 否 | string | 20 | 交易手续费(单位分) | 1 |
| tradeStatus | 是 | string | 32 | 交易状态: INIT-初始,PROCESSING-处理中中,SUCCESS-成功,CLOSE-关闭,FAIL-失败 | SUCCESS |
| failReason | 否 | string | 255 | 失败原因 | |
| finishTime | 否 | string | 32 | 交易完成时间(yyyyMMddHHmmss) | 202411110858 |
备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述