开放平台
  1. 订单系统
开放平台
  • 加解签规则
  • 接口地址
  • 最福利物流编码
  • 渠道方
    • 实物商城-api对接-渠道方使用
      • 类目查询
      • 商品列表
      • 查询同类商品
      • 商品详情
      • 商品价格查询
      • 商品库存查询
      • 地址详情转换地址编码
      • 查询省市区收货地址编码
      • 商品下单
      • 商品物流轨迹
    • 订单系统
      • 确认订单(渠道信息作为用户信息)
        POST
      • 订单状态变更异步通知
        POST
      • 查询订单信息(用户为公司用户)
        POST
  1. 订单系统

订单状态变更异步通知

测试环境
https://t-open.zuifuli.com
测试环境
https://t-open.zuifuli.com
POST
https://t-open.zuifuli.com
第三方提供api地址
根据渠道的订阅,将事件信息推送给渠道方。以下接口除特别说明之外,只说明bizContent结构,渠道请以IcareApiResponse格式返回,resultCode代表0,如果失败最福利将做重试。
渠道方需要提前将回调地址告知最福利。
应用场景#
订单状态变更异步通知外部
接口信息#
serviceNameorder.status.change
version1.0
请求参数#
名称类型必填示例
sourceOrderStatusEnum是原状态
destOrderStatusEnum是目标状态
orderIdLong是订单Id
buyerIdLong是购买Id
serviceCodeString业务大类
itemTypeEnumString订单类型
referenceIdString第三方id
响应信息#
名称类型必填示例说明
orderIdString是891902890128901最福利订单号

OrderStatusEnum#

枚举值说明
START启动
INIT已创建
OL_WAIT_FOR_PAID等待买家付款
PAID已付款
DELIVERED已发货
DONE交易完成 (出报告)
OL_BUYER_WAIT_FOR_REFUND买家申请退款中
OL_CANCEL_BY_REFUND退款中,调用退款接口
OL_BUYER_REFUND_REFUSED退款申请被拒绝
CANCEL_BY_BUYER买家取消订单
BUYER_WAIT_FOR_RETURNS买家申请退货中
SELLER_WAIT_FOR_RETURNS卖家等待买家退货
BUYER_RETURNS_REFUSED退货申请被拒绝
REFUND_DONE退款完成
BUYER_RETURN_WAIT_SELLER_CONFIRM买家已退货等待卖家确认
BUYER_APPLY_REFUND_NOT_RETURN买家申请退款不退货
BUYER_WAIT_FOR_EXCHANGE买家申请换货
CONFIRM_RECEIPT确认收货
CHECKUP_APPOINTMENT已预约
EXPIRED过期
DO_CHECKED到检
WAIT_FOR_OPERATION未到检

请求参数

Body 参数application/x-www-form-urlencoded
channelCode
string 
渠道编号
必需
sign
string 
签名
必需
signType
string 
必需
签名类型,固定值MD5
示例值:
MD5
timestamp
string 
必需
请求时间,yyyy-MM-dd HH:mm:ss
bizContent
string 
必需
json字符串,具体业务参数
version
string 
版本号
必需
serviceName
string 
服务名称
必需
示例值:
order.confirm.channel

示例代码

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://t-open.zuifuli.com第三方提供api地址' \
--data-urlencode 'channelCode=' \
--data-urlencode 'sign=' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'timestamp=' \
--data-urlencode 'bizContent=' \
--data-urlencode 'version=' \
--data-urlencode 'serviceName=order.confirm.channel'

返回响应

🟢200成功
application/json
Body
resultCode
string 
响应码,0为正常
必需
resultDesc
string 
响应描述
必需
timestamp
string 
响应时间
必需
bizContent
string 
必需
json字符串,具体内容见备注
示例
{
    "resultCode": "string",
    "resultDesc": "string",
    "timestamp": "string",
    "bizContent": "string"
}
上一页
确认订单(渠道信息作为用户信息)
下一页
查询订单信息(用户为公司用户)
Built with