申请退款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
market_subsidy_agent_no 营销补贴代理商编号 Sting 1、不上送默认退回到服务商营销补贴代理商编号账户。
2、如上送退回上送营销补贴代理商编号账户
C
market_subsidy_info 营销补贴退款信息 JSONArray 营销不可退款不可大于原交易补贴金额 O
营销补贴信息:market_subsidy_info
参数 参数名称 类型 参数说明 样例 可空
party 营销补贴账户 String 在海科开通的营销补贴账户号 M
amt 营销补贴金额 String 营销补贴金额(单位:元) 20 M
(银联二维码)收款方附加数据: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"
}
文档更新时间: 2023-03-29 10:17   作者:admin