支付退款
查询规则:发起实时退款后,可调用本接口查询退款状态
生产环境请求地址: http://send.tonglian.xyz/refund/search.aspx
请求方法: POST/GET
| 参数名 |
参数值 |
可空 |
加入签名 |
说明 |
| 应用ID |
appId |
否 |
是 |
商户应用ID,商户中心应用管理中获取应用ID |
| 原商户订单号 |
orderId |
否 |
是 |
支付过程中商户系统传入的订单号 |
| 原平台订单号 |
sysOrderId |
否 |
是 |
异步通知过程中传入的原平台订单号 |
| 签名 |
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状态描述 |
| 商户订单号 |
orderId |
|
| 平台订单号 |
sysOrderId |
|
| 退款渠道订单号 |
supplierOrder |
|
返回示例:{"id":0,"code":"SUCCESS","orderId":"260609XXX19415200","sysOrderId":"2606091XXXX0150182","supplierOrder":"202606091XXXXX4","amount":"275","state":"0","message":"当前订单已退款成功"}