主题
交易查询
接口描述
- 商户可以通过查询订单接口主动查询订单状态，完成下一步的业务逻辑。
- 查询订单可通过支付订单号和商户订单号两种方式查询。
请求URL
/trade/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不能同时为空
请求报文示例
json
{
"appId": "202415629590370906",
"outTradeNo": "18511110003547765",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg==",
"transDate": "1731469813663",
"transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 是 | string | 32 | 接入方交易流水号 | OUT00000001 |
| tradeNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
| merchantNo | 是 | string | 32 | 商户号 | XS240820000054 |
| tradeSubject | 是 | string | 255 | 交易标题 | 苹果手机 |
| tradeAmount | 是 | string | 20 | 交易金额(单位分) | 100 |
| tradeFee | 是 | string | 20 | 交易手续费(单位分) | 1 |
| payBrand | 是 | string | 32 | 支付品牌： YOYIPAY-甬易支付，ALIPAY-支付宝，WXPAY-微信支付，UNIONPAY-银联二维码 | YOYIPAY |
| payProduct | 是 | string | 32 | 支付产品： JSAPI-JSAPI支付,APP-APP支付,H5-H5支付,NATIVE-Native支付,MICROPAY:付款码支付 | JSAPI |
| tradeStatus | 是 | string | 32 | 支付状态： INIT-初始,PAYING-支付中,SUCCESS-成功,CLOSE-关闭,FAIL-失败 | PAYING |
| payFinishTime | 否 | string | 32 | 支付完成时间(yyyyMMddHHmmss) | 202411110858 |
| confirmStatus | 是 | string | 32 | 确认状态： INIT-初始,SUCCESS-成功(已确认),CLOSE-关闭 | SUCCESS |
| finishTime | 否 | string | 32 | 交易完成时间(yyyyMMddHHmmss) | 202411110858 |
| terminalNo | 否 | string | 32 | 终端号 | |
| failReason | 否 | string | 255 | 失败原因 |
响应示例
json
{
"code": "00000000",
"merchantNo": "XS241026000093",
"message": "成功",
"outTradeNo": "18511110003547765",
"payBrand": "YOYIPAY",
"payFinishTime": "20241113114701",
"payProduct": "JSAPI",
"tradeAmount": "1",
"tradeFee": "0",
"tradeNo": "1856544267009564674",
"tradeStatus": "INIT",
"tradeSubject": "JMETERTEST",
"transDate": "1731469813663",
"transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述