为了给您提供更好的服务，我们诚邀您填写开放平台使用反馈调研
问题反馈
关闭
接口描述
商户针对某一个已经成功支付的订单发起退款，操作结果在同一会话中同步返回。 一、退款方式 目前只支持原路返回退款 说明：退到银行卡则是非实时的，每个银行的处理速度不同，一般发起退款后1-3个工作日内到账。 总退款金额不能超过用户实际支付金额(现金券金额不能退款) 二、退款限制 商户在退款操作时应该注意退款限制，避免发起不会成功的退款请求，下面是主要的退款限制： 1.在平台系统中，只要退款累计金额不超过交易单支付总额，一笔交易单可以多次退款，退款申请单号（退款接口中有此参数）唯一确定一次退款，而不是交易单号确定一次退款。退款申请单号由商户生成，所以商户一定要保证退款申请单的唯一性。商家在退款过程中要特别注意，只有在能确定退款失败的情况下，才能重新发起另一笔退款。一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号。 2.请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次。 3.错误或无效请求频率限制：6qps，即每秒钟异常或错误的退款申请请求不超过6次。 4.每个支付订单的部分退款次数不能超过50次。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/unifiedTrade/refund?token=[token]&sign=[sign]&ts=[ts]
测试调用地址
https://openapi.unionpay.com/upapi/unifiedTradeTest/refund?token=[token]&sign=[sign]&ts=[ts]
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 时间戳 | ts | long | M-必填 | 单位毫秒，对于Java一般使用System.currentTimeMillis()获取 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。 | |||
| 产品token | token | string | M-必填 |
请求报文体参数 | 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 签名 | sign | string | 32 | M-必填 | MD5签名结果，必填
|
||
| 保留域 | sf_ reserved | string | 64 | O-选填 | 保留域, 商户可在此上送信息,非必填
|
||
| 随机字符串 | nonce_str | string | 32 | M-必填 | 随机字符串，不长于32位，必填
|
||
| 退款终端号 | sf_refund_device_id | string | 8 | O-选填 | 非必填
|
||
| 退款渠道 | refund_channel | string | 16 | ORIGINAL-原路退款 | O-选填 | 非必填
|
|
| 操作员 | op_user_id | string | 32 | 商户号 | M-必填 | 必填
|
|
| 退款金额 | refund_fee | int | M-必填 | 退款总金额,单位为分,可以做部分退款，必填
|
|||
| 总金额 | total_fee | int | M-必填 | 订单总金额，单位为分，必填
|
|||
| 分账信息 | split_info | string | 1 | N | O-选填 | Y：分账，N：不分账
非必填
|
|
| 银联订单详情信息（支持单品） | acq_addn_data | string | 8000 | O-选填 | 由商户上送给银联，银联转发给付款方,本域需整体做Base64编码，本域采用JSON格式，全部内容用“{ }”包含，内部可目前包含“订单信息orderInfo”、“商品信息goodsInfo”两个子域，后续将根据业务需要新增子域。详情见【附录3.8:银联订单详情信息】，非必填
|
||
| 商户退款单号 | out_refund_no | string | 32 | M-必填 | 同一门店唯一，商户退款单号，32个字符内，可包含字母,确保在商户系统唯一。同个退款单号多次请求，平台当一个单处理，只会退一次款。如果出现退款不成功，请采用原退款单号重新发起，避免出现重复退款。银联不支持同一退款单号多次请求，必填
|
||
| 平台订单号 | transaction_id | string | 32 | O-选填 | 平台单号out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先
|
||
| 商户订单号 | out_trade_no | string | 32 | O-选填 | 商户系统内部的订单号,out_trade_no和transaction_id至少一个必填，同时存在时transaction_id优先，银联交易该字段必送
|
||
| 业务类型 | buss_type | string | 2 | 00 | O-选填 | 非必填
|
|
| 门店编号 | op_shop_id | string | 16 | M-必填 | 必填
|
||
| 品牌号 | brand_id | string | 16 | M-必填 | 由平台分配，必填
|
||
| 签名方式 | sign_type | string | 8 | MD5 | O-选填 | 签名类型，非必填
|
|
| 字符集 | charset | string | 8 | UTF-8 | O-选填 | 可选值UTF-8，非必填
|
|
| 版本号 | version | string | 8 | 2.0 | O-选填 | 非必填
|
|
| 接口类型 | service | string | 32 | unified.trade.refund | M-必填 | 必填
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答报文 | data | map | M-必填 | 应答报文
|
|||
| 应答消息 | respMsg | string | M-必填 | 应答消息
|
|||
| 应答码 | respCd | string | 4 | M-必填 | 应答码
|
示例代码
{
"charset":"UTF-8",
"op_user_id":"op_user_id",
"nonce_str":"SF88d5c8986bd0deb6423c92c948",
"out_refund_no":"Tui6375457899689",
"sign":"F53145E553092CE52E4CAA4D2B49A91C",
"op_shop_id":"sfstore1",
"version":"2.0",
"brand_id":"sfbrand1",
"buss_type":"00",
"out_trade_no":"UP597116GZJ05",
"service":"unified.trade.refund",
"total_fee":"1",
"refund_fee":"1",
"sign_type":"MD5"
}
中国银联版权所有©2002-2022沪 ICP备07032180号
