概要描述:

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

注意：
1、交易时间超过90天的订单无法提交退款。
2、预授权订单只支持一次预授权完成或预授权撤销。
3、预授权完成金额不能超过预授权订单金额。

请求URL:

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

参数 参数名称 类型 参数说明 样例 可空
merch_no 海科商户编号 String(32) 海科商户编号 M
out_trade_no 服务商预授权订单号 String(32) trade_no、out_trade_no二选一上送,优选顺序：trade_no、out_trade_no C
trade_no 海科预授权订单号 String(32) trade_no、out_trade_no二选一上送,优选顺序：trade_no、out_trade_no C
out_pre_auth_no 服务商预授权完成订单号 String(32) 服务商内部订单号（同一服务商下唯一） M
total_amount 预授权完成金额 String(12) 预授权完成金额（单位：元） M
pn SAAS终端号 String(32) SAAS终端号 M
notify_url 异步通知地址 String(128) 交易成功异步通知地址 O
remark 备注 String(100) 交易备注 O
extend_params 原生请求参数 JSON 原生参数，透传给通道的参数 O
云闪付原生请求参数:extend_params
参数 参数名称 类型 参数说明 样例 可空
acqAddnData 收款方附加数据 JSON 收款方附加数据 O
(银联二维码)收款方附加数据:acqAddnData
参数 参数名称 类型 参数说明 样例 可空
orderInfo 订单信息 JSON 订单明细内容，如订单标 题、订单描述等 O
goodsInfo 商品信息 JSONArray 商品明细内容 O
(银联二维码)订单信息:orderInfo
参数 参数名称 类型 参数说明 样例 可空
title 标题 String 标题 M
description 订单描述 String 订单描述 O
dctAmount 可优惠金额 String 当前订单可以参与优惠计算的金额 O
addnInfo 附加信息 String 内容自定义 O
(银联二维码)商品信息:goodsInfo
参数 参数名称 类型 参数说明 样例 可空
id 标题 String 标题 M
name 商品名称 String 订单描述 M
price 商品单价 String 以分为单位 M
quantity 商品数量 String 商品数量 M
category 商品类目 String 商品类目 O
addnInfo 附加信息 String 附加信息 O

请求示例:

{
  "agent_no": "FW3002100",
  "req_id": "@id",
  "merch_no": "833103159990017",
  "pn": "APP0006738",
  "trade_no": "WX2412041608080000144086929",
  "out_pre_auth_no": "@id",
  "total_amount": "0.01",
  "extend_params": {
    "body": "商品测试2"
  },
  "remark": "部分完成1分",
  "signKey": "abcdefjhijs24236661ddgarjx",
  "notify_url": "http://39.105.99.14:8080/test/v1/async/notify"
}

返回参数(O-非必传 ,M-必传,C-选传)

参数 参数名称 类型 参数说明 样例 可空
result_code 响应码 String 10000代表业务处理成功，交易结果需要根据trade_status判断 M
result_msg 响应信息 String M
agent_no 服务商编号 String M
merch_no 海科商户编号 String 海科商户编号 M
trade_no 海科完成订单号 String M
pay_type 支付类型 String WX：微信支付
ALI：支付宝支付
UNIONQR：云闪付		 M
trade_status 交易状态 String 1：交易成功
2：交易失败
3：交易进行中		 M
attach 通道原生参数 String O

返回示例:

{
  "merch_no": "833103159990017",
  "result_msg": "请求成功",
  "trade_status": "1",
  "end_time": "2024-12-04 16:21:59",
  "sign": "C8874C8595B415DB02158BD6BA5915F2",
  "trade_no": "WX2412041621580001645120728",
  "agent_no": "FW3002100",
  "pay_type": "WX",
  "result_code": "10000",
  "return_msg": "成功",
  "attach": "{\"nonce_str\":\"dea4cf410d224c09b830c45dab574336\",\"out_refund_no\":\"WX2412041621580001645120728\",\"settlement_refund_fee\":\"1\",\"cert_id\":\"4233741533\",\"return_msg\":\"成功\",\"fee_type\":\"CNY\",\"mch_id\":\"1505378701\",\"sub_mch_id\":\"626185853\",\"refund_id\":\"50101901892024120461940364985\",\"coupon_refund_fee\":\"0\",\"refund_create_time\":\"2024-12-04 16:21:59\",\"appid\":\"wx17728c1a8fa300d6\",\"refund_fee\":\"1\",\"result_code\":\"SUCCESS\",\"cash_refund_fee\":\"1\",\"sign_type\":\"SM2\",\"return_code\":\"SUCCESS\"}",
  "return_code": "SUCCESS"
}
文档更新时间: 2025-01-10 09:25   作者：陈文