开放平台

订单状态推送

正式环境

https://api.zuifuli.com/api/open

POST

/api/xxx

应用场景

订单状态推送，第三方根据 dest 处理自己的业务逻辑，订单状态码详情2.7 订单状态码收到订单状态推送后，建议通过 orderId 调用最福利接口查询下订单详情信息。

接口信息

serviceName	order.status.change
version	1.0

请求bizContent参数

参数名称	类型	必填	说明
orderId	Long	是	最福利订单编号
outOrderId	String	否	外部系统订单编号
source	String	是	订单变更前状态码
dest	String	是	订单变更后状态码
referenceId	String	否	关联订单编号，拆单的情况需要用到该值,参考关于拆单

请求参数

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

nonce

string

随机字符串

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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' \
--data-urlencode 'nonce='

返回响应

🟢200成功

application/json

Body

resultCode

string

响应码，0为正常

必需

resultDesc

string

响应描述

必需

timestamp

string

响应时间

必需

bizContent

string

必需

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

示例

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

查询交易记录

发起退款

订单状态推送

应用场景#

接口信息#

请求bizContent参数#

请求参数

示例代码

返回响应

应用场景

接口信息

请求bizContent参数