交易查询接口
通过交易查询接口获取支付状态。
业务请求参数
| 字段名称 | 字段key | 必填 | 格式 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 固定值：order.query |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 商户订单号 | orderId | O | String(1,40) | 商户订单号和平台订单号不能同时为空 |
| 平台订单号 | transId | O | String(1,40) | 商户订单号和平台订单号不能同时为空 |
请求示例报文
json
{
"appId": "000110011816681",
"funcode": "order.query",
"version": "1.0.0",
"orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953"
}接口同步返回
| 字段名称 | 字段key | 必填 | 类型 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 固定值：order.query |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 商户订单号 | orderId | M | String(1,40) | |
| 平台订单号 | transId | M | String(0,64) | |
| 订单金额 | orderAmount | M | Number(22) | |
| 交易状态 | orderStatus | M | String(4) | 参见 交易状态 |
| 订单开始时间 | orderStartTime | O | String(14) | 下单成功时返回 |
| 订单过期时间 | orderExpireTime | O | String(14) | 下单成功时返回 |
| 支付方式 | payMethod | O | String(14) | 支付成功时返回，参见 支付方式 |
| 支付成功时间 | payTime | O | String(14) | 支付成功时返回 |
| 响应时间 | responseTime | M | String(14) | |
| 响应码 | responseCode | M | String(1,16) | 参见 交易响应码 |
| 响应信息 | responseMsg | M | String(1,200) | 参见 交易响应码 |
| 错误码 | errorCode | O | String(1,16) | 请求失败时返回 参见 交易错误码 |
| 错误信息 | errorMsg | O | String(200) | 请求失败时返回 参见 交易错误码 |
注意
- 商户订单号与APPID组成唯一约束。
- payUrl为调用钱包短链接。
- 用户支付成功后通过异步通知、交易查询接口获取支付状态。
返回示例报文
json
{
"appId": "000110011816681",
"funcode": "order.query",
"orderAmount": "1000",
"orderExpireTime": "20240108103907",
"orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
"orderStartTime": "20240108093907",
"orderStatus": "pending",
"responseCode": "success",
"responseMsg": "请求成功",
"responseTime": "20240108095249",
"transId": "2401080939076440202",
"version": "1.0.0"
}