支付退款

退款规则:原交易存在、且原交易可退金额大于等于本次退款金额、且商户当日正向交易头寸大于等于本次退款金额。
支持部分退款、全额退款

生产环境请求地址: http://send.tonglian.xyz/refund/apply.aspx
请求方法: POST/GET

参数名 参数值 可空 加入签名 说明
应用ID appId 商户应用ID,商户中心应用管理中获取应用ID
原商户订单号 orderId 支付过程中商户系统传入的订单号
原平台订单号 sysOrderId 异步通知过程中传入的原平台订单号
部分退款金额 amount 部分退款金额不能大于原始成功金额
签名 sign SHA256WITHRSA商户私钥进行签名,平台以商户公钥进行验签,商户公私钥由在应用管理中获取,密钥位数为2048

签名说明

为了保证数据传输过程中的数据真实性和完整性,我们需要对数据进行数字签名,平台在接收签名数据之后进行签名校验,以验证数据报文的真实性及有效性,防止报文被恶意篡改。
签名生成规则:上送报文体中,业务数据appId={0}&orderId={1}&sysOrderId={2}即为签名原文其中{}为占位符,将其使用约定的签名算法计算得到签名。sign = RSA私钥加签(待签名串, 商户私钥)
目前仅支持SHA256WithRSA签名方式,签名时需使用平台提供的商户私钥进行签名。得到签名后,需要将其放入报文体的sign字段中一起上送,以供服务端进行签名验证。

参数名 参数值 说明
ID id 0 成功,1 失败
状态code code SUCCESS 成功,Fail 失败
状态描述 message 状态描述
支付状态 state 0 退款成功 非0退款失败,具体查看message状态描述

返回示例:{"id":0,"code":"SUCCESS","orderId":"2025081117262XXX","amount":"0.20","state":"0","message":当前订单已退款成功""}