发起退款

当客户发起退款申请时服务商可以通过调用退款接口进行退款

1.接口说明

发起退款接口

2.业务时序图

3.接口定义

path 请求方式 接口描述 调用权限
/refund/refundApply POST 发起退款 第三方支付角色

4.请求头说明

名称 是否必须 类型 默认值 备注
Content-Type true string application/json N/A

5.请求参数说明

名称 是否必须 类型 传值范围 默认值 备注
merchantNo true string 3~32(字符长度) N/A 商户号
tradeOrderNo true string 3~32(字符长度) N/A 业务订单号
refundNo true string 3~32(字符长度) N/A 退款单号
amount true decimal 0.01~999999.99(值范围) N/A 退款金额，最多支持两位小数

请求示例：

{
    "merchantNo": "wb1110000000",
    "paymentOrderNo": "100000",
    "refundNo ": "234232",
    "amount": "100.23"
}

6.返回参数说明

名称 是否必须 类型 备注
ret true string 请求是否正常返回状态码："-1"请求异常 ,"0":请求成功
errorCode true string 请求成功返回null，失败返回code码
msg true string 成功返回"ok",失败返回错误信息
success true boolean 成功返回true，失败返回false
data false object 成功返回数据主体,失败不返回
paymentOrderNo 依赖data字段 string 业务订单号
refundNo 依赖data字段 string 退款订单号
serialNo 依赖data字段 string 流水号
amount 依赖data字段 string 退款金额
status 依赖data字段 string 退款状态：0(退款失败)、1(退款成功)

返回示例：

{
  "ret": "0",
  "errorCode": null,
  "msg": "ok",
  "success": true
  "data": {
    "paymentOrderNo": "3223243543545435",
    "refundNo": "3223243543545435",
    "serialNo": "3223243543545435",
    "status": 1,
    "amount": 100
  }
}

results matching ""

    No results matching ""