文档中心 支付接口 退款接口

退款接口

1.功能说明

退款

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/pay/refund

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
outer_trade_no string [2,22] 外部交易号,需保证唯一性
reason string [1,100] 退款原因
amount decimal(10,2) [0.01,99999999.99] 退款金额
refund_trade_no string [2,22] 退款交易号,需保证唯一性
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data 如果没有错误,返回refund_trade_no
请求示例
POST /pay/refund HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=a7e28ec1af8a2fb8507e78d7f2d56151&amount=1&outer_trade_no=0000000000000000000141&
reason=test&refund_trade_no=1000000000000000000141&&sign=03f2855fe01005c7f9827ca1d5f0480446c24fe6
timestamp=1505277010&version=1.0.0
                    
正确返回示例
{
    "code": 0,
    "data": "1000000000000000000141",
    "msg": "OK"
}
错误返回示例
{
    "code": 1000481020,
    "data": null,
    "msg": "退款金额不能超过交易金额"
}