主题
单笔退款查询
接口描述
- 提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，建议查询退款状态在提交退款申请后1分钟发起，一般来说余额支付的退款5分钟内到账，银行卡支付的退款1-3个工作日到账。
请求URL
/refund/query
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outRefundNo | 否 | string | 32 | 接入方退款流水号(与refundNo不可同时为空) | OUT00000001 |
| refundNo | 否 | string | 32 | 支付系统退款流水号(与outRefundNo不可同时为空) | 1854100814175592449 |
- 注：outRefundNo与refundNo不能同时为空
请求报文示例
json
{
"appId": "202415629590370906",
"outRefundNo": "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 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outRefundNo | 是 | string | 32 | 接入方退款流水号 | OUT00000001 |
| tradeNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
| refundNo | 是 | string | 32 | 支付系统退款流水号 | 1854100814175590018 |
| refundAmount | 是 | string | 20 | 退款金额(单位分) | 100 |
| refundStatus | 是 | string | 32 | 退款状态： INIT-初始,PAYING-处理中,SUCCESS-成功,CLOSE-关闭,FAIL-失败 | SUCCESS |
| finishTime | 否 | string | 32 | 退款完成时间(yyyyMMddHHmmss) | 202411110858 |
响应示例
json
{
"code": "00000000",
"outRefundNo": "OUT00000001",
"message": "成功",
"tradeNo": "1854100814175592449",
"refundNo": "1854100814175590018",
"refundAmount": "100",
"refundStatus": "SUCCESS",
"finishTime": "202411110858",
"transDate": "1731469813663",
"transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述