订单推送接口
需求场景:
开发者订阅订单状态通知接口,支持开发者自有商品 和 兑吧商品。
接口说明:
订单数据的传输接口是由开发者提供,兑吧服务器在有新的订单数据产生的时候,通过该接口将订单数据的相关信息传输给开发者服务器,开发者通过接口接收数据,在本地进行和相关处理,并给兑吧服务器响应处理结果。
订单推送流程图
接口对接
1)开发者配置订单通知接口
2)开发者选择订单状态,待审核,待发货,待售后,成功,失败
配置方式:开发者提供订单通知地址,appid,及需要配置的任务状态给兑吧技术支持
请求方式(post):兑吧post请求到开发者配置的订单通知接口。
接口参数说明:
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
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 | 必须 | 收货人姓名 |
开发者响应参数:
成功:响应ok
开发者服务器端收到请求并处理完成后,请返回纯文本的 ok 字符串,两边不带空格,忽略大小写,兑吧在验证到响应为 ok 后就不再继续请求
失败:除 ok 以外的任何响应。
重试:兑吧会在失败之后的1分钟、3分钟、5分钟、10分钟、20分钟重复发送请求。