主题
退款申请
接口描述
- 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，甬易支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。
- 注意：交易时间超过6个月的订单无法提交退款（按支付成功时间+180天计算），每个支付订单的部分退款次数不能超过20次
请求URL
/refund/apply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| tradeNo | 是 | string | 32 | 支付系统交易流水号(原交易单号) | 1856544267009564674 |
| outRefundNo | 是 | string | 32 | 接入方退款流水号 | OUT00000001 |
| refundAmount | 是 | string | 20 | 退款金额(单位分) | 100 |
| refundReason | 否 | string | 255 | 退款原因 | 货物损坏不要了 |
| notifyUrl | 否 | string | 255 | 通知回调地址 | https://aaa.bbb.com/trade/notify |
| psReturnFlag | 否 | string | 是否分账回退,默认不回退： Y-回退，N-不回退； | N | |
| psReturnDetail | 否 | string | 分账回退详情(json字符串) | ||
| - amount | 否 | number | 20 | 分账子订单金额(单位分)，psReturnFlag为Y是必填 | 50 |
| - outMerchantNo | 否 | string | 32 | 回退商户号，psReturnFlag为Y是必填 | XS240820000050 |
请求报文示例
json
{
"appId": "202415629590370906",
"merchantNo": "XS241026000093",
"openId": "yoyipay1jcd7fu45tk01",
"tradeNo": "18511110003547765",
"outRefundNo": "OUT00000001",
"refundAmount": "100",
"refundReason": "货物损坏不要了",
"notifyUrl":"https://aaa.bbb.com/trade/notify",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| refundNo | 是 | string | 32 | 支付系统退款流水号 | 1854100814175592449 |
| outRefundNo | 是 | string | 32 | 接入方退款流水号 | OUT00000001 |
| refundAmount | 是 | string | 20 | 退款金额(单位分) | 100 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"refundNo": "1856544267009564674",
"outRefundNo": "OUT00000001",
"refundAmount": "100",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述