开放平台
  1. 第三方系统收银台-积分在外部系统-渠道方使用
开放平台
  • 加解签规则
  • 接口地址
  • 关于小程序
  • 供应商
    • 登录相关
      • 外部跳转最福利
        • 个人用户免密登录-代理版本
  • 渠道方
    • 第三方系统收银台-积分在外部系统-渠道方使用
      • 余额查询
        POST
      • 发起收银
        POST
      • 收银异步通知
        POST
      • 查询交易记录
        POST
      • 订单状态推送
        POST
      • 发起退款
        POST
  1. 第三方系统收银台-积分在外部系统-渠道方使用

发起退款

正式环境
https://api.zuifuli.com/api/open
正式环境
https://api.zuifuli.com/api/open
POST
https://api.zuifuli.com/api/open
/api/xxx
应用场景#
最福利通知渠道方进行退款操作,订单退款以最福利退款金额为准退款接口需支持退全部和部分金额,且有可能对同一笔订单进行多次退款如果渠道方接口调用失败,最福利会尝试重新调用若干次该接口,最多12 次,时间间隔逐步增大,渠道方需要做好接口幂等
接口信息#
serviceNametrade.refund
version1.0
请求bizContent参数#
参数名称类型必填说明
thirdUserString是第三方用户 id
extraInfoString否免密登陆最福利带过来的信息
outTradeNoString否最福利交易唯一标识
tradeNoString否第三方交易唯一标识
refundNoString是最福利退款交易号,用于查询,重复判断
reasonString否退款原因
amountLong是退款金额,单位 人民币的分
orderIdLong否最福利订单号
refundDateDateTime是退款发起日期
subOrderIdsString是最福利退款子订单号,可能会有多个,逗号分割
响应 bizContent 参数#
参数名称类型必填说明
refundTradeNoString是退款单号
amountLong是退款金额

请求参数

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.zuifuli.com/api/open/api/xxx' \
--data-urlencode 'channelCode=' \
--data-urlencode 'serviceName=balance.query' \
--data-urlencode 'version=1.0' \
--data-urlencode 'thirdUserId=' \
--data-urlencode 'custId=' \
--data-urlencode 'phone=' \
--data-urlencode 'bizContent=' \
--data-urlencode 'timestamp=' \
--data-urlencode 'charset=' \
--data-urlencode 'format=' \
--data-urlencode 'sign=' \
--data-urlencode 'signType=MD5'

返回响应

🟢200成功
application/json
Body
resultCode
string 
响应码,0为正常
必需
resultDesc
string 
响应描述
必需
timestamp
string 
响应时间
必需
bizContent
string 
必需
json字符串,具体内容见备注
示例
{
    "resultCode": "string",
    "resultDesc": "string",
    "timestamp": "string",
    "bizContent": "string"
}
上一页
订单状态推送
Built with