订单推送接口

需求场景：

开发者订阅订单状态通知接口，支持开发者自有商品和兑吧商品。

接口说明：

订单数据的传输接口是由开发者提供，兑吧服务器在有新的订单数据产生的时候，通过该接口将订单数据的相关信息传输给开发者服务器，开发者通过接口接收数据，在本地进行和相关处理，并给兑吧服务器响应处理结果。

订单推送流程图

接口对接

1）开发者配置订单通知接口

2）开发者选择订单状态，待审核，待发货，待售后，成功，失败

配置方式：开发者提供订单通知地址，appid，及需要配置的任务状态给兑吧技术支持

请求方式（post）：兑吧post请求到开发者配置的订单通知接口。

数据格式：application/json

接口参数说明：

参数	类型	是否必填	说明
appKey	string	必须	接口appKey，应用的唯一标识
timestamp	string	必须	请求时间戳，当前时间毫秒值
uid	string	必须	用户id
orderNum	string	必须	兑吧订单号
developBizId	string	非必须	开发者订单号（扣积分时返回）
createTime	string	必须	下单时间，单位：时间戳，下单时间毫秒值
finishTime	string	非必须	订单完结时间，单位：时间戳，订单完结时间毫秒值
totalCredits	string	必须	总积分
consumerPayPrice	string	必须	用户支付总金额，单位：元
source	string	必须	订单来源，普兑，刮刮乐大转盘等
orderStatus	string	必须	订单状态 waitAudit待审核，waitSend待发货，afterSend已发货待售后，success成功，fail失败
errorMsg	string	非必须	失败原因
type	string	必须	订单类型：商品类型object（实物），coupon(优惠券，卡密也是优惠券类型)，virtual（虚拟商品）,alipay（支付宝），phonebill（话费），qb
expressPrice	string	必须	运费，单位：元
account	string	非必须	直充账号
orderItemList	string	必须	子订单信息 item 类型: string
receiveAddrInfo	string	非必须	收货地址信息（实物商品必填）
sign	string	必须	签名 md5

orderItemList明细信息

参数	类型	是否必填	说明
title	string	必须	商品名称
isSelf	string	必须	是否自有商品 0否1是
smallImage	string	必须	图片地址
merchantCode	string	非必须	商家编码
perCredit	string	必须	单个商品对应的积分
perPrice	string	必须	单价，单位：元
quantity	string	必须	数量
code	string	非必须	优惠券码（优惠券/卡密必填）
password	string	非必须	密码（卡密必填）
cardBeginTime	string	非必须	优惠券有效期开始时间（优惠券/卡密必填），单位：时间戳，优惠券有效期开始时间毫秒值
cardEndTime	string	非必须	优惠券有效期结束时间（优惠券/卡密必填），单位：时间戳，优惠券有效期结束时间毫秒值
deliveryCompanyNo	string	非必须	物流单号（实物必填）
deliveryCompanyName	string	非必须	物流公司（实物必填）
duibaSupplyPrice	string	非必须	供货价

receiveAddrInfo明细信息

参数	类型	是否必填	说明
province	string	必须	省
city	string	必须	市
area	string	必须	区
street	string	必须	街道
address	string	必须	详细地址
mobile	string	必须	手机号
name	string	必须	收货人姓名

请求示例：

{
orderItemList : "[{"perPrice":"0.01","smallImage":"//yun.duiba.com.cn/images/202306/jc82y5ul3w.jpg","quantity":"1","title":"（测试）测试面条 ","isSelf":"1","perCredit":"0"}]"
sign : "968e4ac177b03e0c6dfaed87712734e4"
orderNum : "233435231568164C0629"
orderStatus : "waitAudit"
receiveAddrInfo : "{"area":"XXX","address":"XXX","province":"XXX","city":"XXX","street":"XXX街道","name":"张三","mobile":"11011011111"}"
source : "普通兑换"
type : "object"
uid : "9527"
totalCredits : "0"
createTime : "1686107167000"
}
//验签时请转换成字符串格式

开发者响应参数：

成功：响应ok
开发者服务器端收到请求并处理完成后，请返回纯文本的 ok 字符串，两边不带空格，忽略大小写，兑吧在验证到响应为 ok 后就不再继续请求
失败：除 ok 以外的任何响应。
重试：兑吧会在失败之后的1分钟、3分钟、5分钟、10分钟、20分钟重复发送请求。

订单接口