交易查询
成功返回钱包支付短链接后,商户可通过交易查询接口获取支付状态。
业务请求参数
| 字段名称 | 字段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": "768a8AdD-cB8b-084A-C689-dcEFbC3D9F65",
"transId": "2401081110426512201"
}接口同步返回
| 字段名称 | 字段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) | 下单成功时返回 |
| 响应时间 | 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": "227833",
"orderExpireTime": "20240108121043",
"orderId": "768a8AdD-cB8b-084A-C689-dcEFbC3D9F65",
"orderStartTime": "20240108111043",
"orderStatus": "success",
"responseCode": "success",
"responseMsg": "请求成功",
"responseTime": "20240108113351",
"transId": "2401081110426512201",
"version": "1.0.0"
}