开放平台
  1. 最福利收银台-积分在外部系统-渠道方使用
开放平台
  • 加解签规则
  • 接口地址
  • 关于小程序
  • 最福利订单状态枚举
  • 供应商
    • 登录相关
      • 外部跳转最福利
        • 个人用户免密登录-代理版本
        • 个人用户免密登录-普通版本
  • 渠道方
    • 最福利收银台-积分在外部系统-渠道方使用
      • 余额查询
        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
应用场景#
用于最福利发起支付,第三方扣款失败时如需展示失败原因,需返回resultCode=12005,,第三方需要校验用户的可用积分余额是否可以支付订单金额
接口信息#
serviceNametrade.pay
version1.0
请求bizContent参数#
参数名称类型必填说明
thirdUserString是第三方用户 id
totalLong否用户免密登陆传入信息
amountLong是第三方扣款金额,单位 人民币的分,也就是用户应付积分金额,渠道需要校验用户可用积分余额
outTradeNoString是最福利的交易编号,用于查询,重复判断
subjectString是订单描述
orderDateDateTime是下单日期
orderIdsString是宜员订单号,多个订单号使用逗号分割,可以使用订单号查询具体交易明细
orderInfoJSONString json 数组字符串是订单信息,最福利一个交易包含至少一笔订单,第三方可据此构造自己 的 订 单 记录, 结构请参照orderInfo 不建议使用
OrderInfo#
参数名称类型必填说明
buyerIdLong是最福利用户编号
phoneString否第三方免登时传递过来的用户手机号码,如果免登时未传入手机号码 , 则 这 里是channelCode ^thirdUserId
orderIdString是最福利订单编号
tradeInfoObject否收货地址信息,参考TradeInfo
feeLong是订单金额 ,单位分
serviceNameString否最福利商品分类
shipFeeLong是运费,单位分
serviceCodeString否最福利商品分类编号
sourceIdString否如果是京东商城的商品,此值为京东订单编号
itemsArray是订单商品信息,参考Item
TradeInfo#
参数名称类型必填说明
nameString是收货人
phoneString是联系方式
detailString是收货地址
Item#
参数名称类型必填说明
feeLong是商品金额,单位分
mainImageString是商品大图
itemIdLong是最福利商品编号
quantityInteger是商品数量
skuIdLong是最福利 SkuId
subOrderIdLong是最福利子订单编号
titleString是商品名称
响应bizContent参数#
参数名称类型必填说明
thirdUserString是第三方用户 id
outTradeNoString是最福利的交易编号,用于查询,重复判断
tradeNoString是第三方交易号,后续用于查询或者退款

请求参数

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