概要描述:

当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，微信支付将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。

注意：
1、交易时间超过90天的订单无法提交退款。
2、退款支持单笔交易分多次退款，多次退款需要提交原支付订单订单号（服务商交易订单号、海科交易订单号、支付凭证号三选一）和设置不同的退款单号。
3、申请退款总金额不能超过订单金额。
4、若原支付订单完成过分账，则退款时可选择是否将原分账资金做退回。

请求URL:

  • 测试环境：/refund

请求参数(O-非必传 ,M-必传,C-选传)

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String M
merch_no 海科商户编号 String 海科商户编号 M
out_trade_no 服务商支付订单号 String trade_no、out_trade_no、voucher_no三选一上送,优选顺序：trade_no、out_trade_no、voucher_no C
trade_no 海科支付订单号 String trade_no、out_trade_no、voucher_no三选一上送,优选顺序：trade_no、out_trade_no、voucher_no C
voucher_no 支付凭证号 String trade_no、out_trade_no、voucher_no三选一上送,优选顺序：trade_no、out_trade_no、voucher_no C
out_refund_no 服务商退款订单号 String 服务商内部订单号（同一服务商下唯一） M
refund_amount 退款金额 String 退款金额（单位：元） M
ledger_info 分账退回明细 JSONARRAY 分账资金归集明细，填写后按照分账退回明细做资金归集后退款，不填则直接按退款金额进行退款 O
sign 签名 String 签名 M
分账退回明细:ledger_info
参数 参数名称 类型 参数说明 样例 可空
receive_store_no 收账门店编号(海科门店编号) String 收账方(海科门店编号) M
amt 分账金额 String 分账金额（单位：元） 20 M

请求示例:

{
    "agent_no": "IS88888888",
    "merch_no": "83388888888",
    "out_trade_no": "123456789",
    "out_refund_no": "R123456789",
    "refund_amount": "0.01",
    "sign": "5F154E14FDC459ED5DF628B56F61A609"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
return_code 响应码 String 10000代表成功 M
return_msg 响应信息 String M
agent_no 服务商编号 String M
merch_no 海科商户编号 String 海科商户编号 M
out_refund_no 服务商退款订单号 String M
refund_no 海科退款订单号 String M
refund_amount 退款金额 String 退款金额（单位：元） M
trade_status 交易状态 String M
sign 签名 String 签名 M

pay_type=WX时返回:

参数 参数名称 类型 参数说明 样例 可空
cash_refund_fee 现金退款金额 String 现金退款金额，单位为分，只能为整数 O
settlement_refund_fee 退款金额 String 去掉非充值代金券退款金额后的退款金额，退款金额=申请退款金额-非充值代金券退款金额，退款金额<=申请退款金额 O
coupon_refund_fee 代金券退款总金额 String 代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金 O
refund_detail 优惠退款详情 JSON 优惠退款功能信息 O

微信优惠功能refund_detail:

参数 参数名称 类型 参数说明 样例 可空
promotion_id 券ID String 券或者立减优惠id M
scope 优惠范围 String GLOBAL- 全场代金券
SINGLE- 单品优惠		 SINGLE O
type 优惠类型 String COUPON- 代金券，需要走结算资金的充值型代金券,（境外商户券币种与支付币种一致）
DISCOUNT- 优惠券，不走结算资金的免充值型优惠券，（境外商户券币种与标价币种一致		 DISCOUNT O
amount 优惠券面额 int 用户享受优惠的金额 5 O
refund_amount 优惠券退款额 int 按比例退款的优惠券金额 5 O

pay_type=ALI时返回:

参数 参数名称 类型 参数说明 样例 可空
send_back_fee 本次商户实际退回金额 String 本次商户实际退回金额 M
buyer_user_id 买家在支付宝的用户id String 买家在支付宝的用户 id M
refund_detail_item_list 退款使用的资金渠道 JSONARRAY 交易支付使用的资金渠道 M
present_refund_buyer_amount 本次退款金额中买家退款金额 String 本次退款金额中买家退款金额 O
present_refund_discount_amount 本次退款金额中平台优惠退款金额 String 本次退款金额中平台优惠退款金额 O
present_refund_mdiscount_amount 本次退款金额中商家优惠退款金额 String 本次退款金额中商家优惠退款金额 O
支付宝交易支付使用的资金渠道:refund_detail_item_list
参数 参数名称 类型 参数说明 样例 可空
fund_channel 交易使用的资金渠道 String(32) 交易使用的资金渠道 M
bank_code 银行卡支付时的银行代码 String(10) 银行卡支付时的银行代码 O
amount 该支付工具类型所使用的金额 Double 该支付工具类型所使用的金额 M
real_amount 渠道实际付款金额 Double 渠道实际付款金额 M
fund_type 渠道所使用的资金类型 String(32) 目前只在资金渠道 (fund_channel) 是 银 行 卡 渠 道(BANKCARD)的情况下才返回该信息:
DEBIT_CARD:借记卡
CREDIT_CARD:信用卡
MIXED_CARD:借贷合一卡		 O

pay_type=UNIQR时返回:

参数 参数名称 类型 参数说明 样例 可空
couponInfo 优惠信息 JSONARRAY 优惠信息 O

云闪付优惠信息couponInfo

参数 参数名称 类型 参数说明 样例 可空
spnsrId 出资方 String 银联作为出资方：固定填写00010000；付款方作为出资方：填写 8 位付款方机构代码商户作为出资方：填写 15 位商户代码(银联商户号)。 M
offstAmt 优惠金额 String 以分为单位 M

返回示例:

{
    "agent_no": "IS88888888",
    "merch_no": "83388888888",
    "out_refund_no": "123456789",
    "refund_no": "AL88888888",
    "trade_status": "1",
    "return_code": "10000",
    "return_msg": "成功",
    "send_back_fee": "88.88",
    "refund_detail_item_list": [
        {
                "fund_channel": "ALIPAYACCOUNT",
                "amount": 10,
                "real_amount": 11.21
        }
    ],
    "buyer_user_id": "2088101117955611",
    "sign": "1032A57E96E4048B27EC2A5C3CE5E663"
}
文档更新时间: 2024-01-12 16:04   作者：陈文