发起退款

应用场景

最福利通知渠道方进行退款操作，订单退款以最福利退款金额为准退款接口需支持退全部和部分金额，且有可能对同一笔订单进行多次退款如果渠道方接口调用失败，最福利会尝试重新调用若干次该接口，最多12 次，时间间隔逐步增大，渠道方需要做好接口幂等

接口信息

serviceName	trade.refund
version	1.0

请求bizContent参数

参数名称	类型	必填	说明
thirdUser	String	是	第三方用户编号
extraInfo	String	否	免密登陆最福利带过来的信息
outTradeNo	String	是	最福利交易号
tradeNo	String	是	第三方交易号
refundNo	String	是	最福利退款交易号,用于查询,重复判断
reason	String	否	退款原因
amount	Long	是	退款金额，单位人民币的分
orderId	Long	是	最福利订单号
refundDate	DateTime	是	退款发起日期
subOrderIds	String	是	最福利子订单编号，如果有多个子订单，编号会用逗号分割

响应 bizContent 参数

参数名称	类型	必填	说明
refundTradeNo	String	是	第三方退款单号
amount	Long	是	退款金额

请求参数

Body 参数application/x-www-form-urlencoded

channelCode

string

渠道编号

必需

serviceName

string

服务名称

必需

示例值:

balance.query

version

string

版本号

必需

示例值:

1.0

thirdUserId

string

第三方用户唯一标识

可选

custId

string

最福利用户编号

可选

phone

string

用户手机号码

可选

bizContent

string

必需

json字符串，具体业务参数

timestamp

string

必需

请求时间，yyyy-MM-dd HH:mm:ss

charset

string

固定值 UTF8

必需

format

string

固定值 json

必需

sign

string

签名

必需

signType

string

必需

签名类型，固定值MD5

示例值:

MD5

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

resultCode

string

响应码，0为正常

必需

resultDesc

string

响应描述

必需

timestamp

string

响应时间

必需

bizContent

string

必需

json字符串，具体内容见备注

示例

{
    "resultCode": "string",
    "resultDesc": "string",
    "timestamp": "string",
    "bizContent": "string"
}

应用场景#

接口信息#

请求bizContent参数#

响应 bizContent 参数#

请求参数

示例代码

返回响应

应用场景

接口信息

请求bizContent参数

响应 bizContent 参数