申请退款API
业务功能
商户针对某一个已经成功支付的订单发起退款,操作结果在同一会话中同步返回。
一、退款方式
目前只支持原路返回退款。
说明:
· 退到银行卡则是非实时的,每个银行的处理速度不同,一般发起退款后1-3个工作日内到账。
· 同一笔单的部分退款需要设置相同的订单号和不同的 out_refund_no 。
· 一笔退款失败后重新提交,要采用原来 的out_refund_no。
· 总退款金额不能超过用户实际支付金额(现金券金额不能退款)
· 部分退款次数最多不能超过15次。
交互模式
请求:后台请求交互模式
返回结果+通知:后台请求交互模式+后台通知交互模式
测试url:
http://47.95.131.62:8080/api/v1/pay/uniqr/refund
请求参数(O-非必传 ,M-必传):
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
out_refund_no | 服务商退款订单号 | String | 服务商退款订单号(同一服务商下唯一) | 161018121614000624679888 | M |
trade_no | 交易订单号 | String | SaaS平台的交易订单编号 | trade_no、out_trade_no、channel_trade_no必传其中一个,都传则以trade_no为准,推荐使用trade_no | O |
out_trade_no | 原服务商交易订单号 | String | 原服务商交易订单号(v1.24增加) | O | |
channel_trade_no | 凭证条码订单号 | String | 付款凭证条码订单号(v1.28增加) | 161018121614000624679888 | O |
notify_url | 通知地址(v1.02) | String | 退款成功后的通知地址 | http://test.mdun.cn/jd/pay/notice | O |
sn | 厂商终端号 | String | (v1.05增加) | O | |
pn | SAAS终端号 | String | 标准服务商必填(v1.27增加) | O | |
remark | 交易备注 | String | (v1.05增加) | O | |
acq_addn_data | (银联二维码)收款方附加数据 | JSON | 涉及扫码点餐业务,交易需要在此上送商品信息 | O | |
refund_amount | 退款金额 | String | 1、填写金额按照填写金额进行退款 2、未填写金额按照交易金额进行退款 |
O |
(银联二维码)收款方附加数据:acq_addn_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
orderInfo | 订单信息 | JSON | 订单明细内容,如订单标 题、订单描述等 | O |
(银联二维码)订单信息:orderInfo
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
addnInfo | 附加信息 | String | 银联扫码点餐相关参数,格式参考银联侧要求,例如{brandId=值&storeId=值&tableNo=值} | O |
请求示例:
{
"accessid": "cpostest",
"out_refund_no": "20190506170040729",
"trade_no": "UN190505194842300000778252",
"out_trade_no": "20190506170040729",
"notify_url": "http://47.95.131.62:8080/saas/trade/success/notice/test",
"sign": "5799A557E6E53E4ABF75EC9878AC774E"
}
返回参数:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
refund_no | 退款订单号 | String | SaaS平台的退款订单编号 | M | |
channel_trade_no | 凭证条码订单号 | String | 凭证条码订单号(v1.24增加) | 161018121614000624679888 | M |
refund_status | 退款状态 | String | 退款结果:
1:成功(退款申请接收成功,退款的到账时间以实际为准); 2:失败(退款申请失败,错误原因参考status_msg); 3:结果未知(退款申请处理结果未知,通过对账进行处理) |
M | |
refund_amount | 退款金额 | String | (v1.14增加) | M | |
error_code | 错误码 | String | O | ||
error_msg | 错误消息 | String | O | ||
total_amount | 原消费交易总金额 | String | 原消费交易总金额(v1.30增加) | M | |
refunded_amount | 已退款金额 | String | 已退款金额(v1.30增加) | M | |
remanent_amount | 剩余可退款金额 | String | 剩余可退款金额(v1.30增加) | M | |
attach | 银联原生参数 | JSON | O |
银联原生参数:attach
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
acqAddnData | 收款方附加数据 | String | BASE64加密后的字符串 | M | |
issAddnData | 付款方附加数据 | String | BASE64加密后的字符串 | M | |
couponInfo | 优惠类信息(银联单品券时使用) | String | BASE64加密后的字符串,解码后为JSONArray | M |
couponInfo:优惠信息
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
spnsrId | 出资方 | String | 银联作为出资方:固定填写00010000;付款方作为出资方:填写 8 位付款方机构代码商户作为出资方:填写 15 位商户代码(银联商户号)。 | M | |
offstAmt | 优惠金额 | String | 以分为单位 | M | |
currencyCode | 货币类型 | String | 固定:156代表人民币 | O | |
id | 项目编号 | String | 用于票券编号等,格式自定义 | O | |
desc | 优惠活动简称 | String | 可用于展示、打单等 | O | |
addnInfo | 附加信息 | String | O |
返回示例:
错误:
{
"return_code":30070,
"return_msg":"退款时间已截止,禁止交易",
"sign":"110D9FC5B177882A8CD0BB4E78E32D8F"
}
文档更新时间: 2025-02-11 11:08 作者:admin