1.创建订单
创建订单
- 需要申请添加IP白名单,此接口仅代表下单状态
- URL: /order/createOrder
- 命令: HTTP POST
- Request 参数格式
| 参数名称 | 参数类型 | 参数说明 | 必传 |
|---|---|---|---|
| phoneNum | string | 手机号码(合作方下单前必须校验手机号正确性) | 是 |
| outOrderNum | string | 外部订单号 | 是 |
| os | int | 系统 1 ios 2 android | 否 |
| goodsType | int | 商品类型(1 安卓懒人币,2 ios懒人币,3 vip充值,4 有声书籍,5 付费节目,6 合辑) | 是 |
| goodsId | int | 商品ID | 否 |
| goodsNum | int | 商品数量 | 是 |
| originalTotalFee | int | 商品原价(单位为分) | 是 |
| userPayTotalFee | int | 用户付款金额(单位为分) | 否 |
| payTotalFee | int | 懒人收款金额(单位为分) | 否 |
- Response格式
| 参数名称 | 参数类型 | 参数说明 |
|---|---|---|
| orderNo | String | 订单号 |
| createTime | long | 创建时间(时间戳) |
| originalTotalFee | int | 商品原价(单位为分) |
| userPayTotalFee | int | 用户付款金额(单位为分) |
| payTotalFee | int | 懒人收款金额(单位为分) |
| status | int | 下单状态,0表示成功 |
| msg | String | 描述信息 |
- 状态码
| status | 说明 |
|---|---|
| 0 | 下单成功 |
| 1 | 下单失败,失败原因见msg |
| 7 | 没权限访问该接口 |
| 15 | 参数格式错误 |
| 16 | 用户创建失败 |
| 17 | 非法下单(用户不匹配) |
| 21 | 合作方非法 |
| 22 | 分销业务已截至 |
| 23 | 书籍ID不存在 |
| 27 | 单个用户下单限制 |
| 28 | 分销价格错误 |
| 38 | token校验失败 |
| 39 | ip不在白名单 |
- 返回示例
{
"result":{
"orderNo":62223800099,
"createTime":1596531878000,
"userPayTotalFee":100,
"originalTotalFee":100,
"payTotalFee":50,
"status":0,
"msg":"下单成功!"
}
}
- 此接口状态码仅代表下单状态,若要确定交易是否完成、权益是否生效?在此接口返回下单成功的情况下,再调用查询订单接口,以查询接口状态为准。
会员下单补充
- goodsType=3 购买VIP
- goodsNum=1 购买月卡, goodsNum=3 购买季卡, goodsNum=6 半年卡,goodsNum=12 购买年卡,
- os 字段:
当合作方无法获取到用户 os 时,可以不传,我方将默认为安卓,此字段关系到 originalTotalFee 字段,当不传时,originalTotalFee 字段按安卓处理; -
originalTotalFee 字段
测试环境与正式环境统一参数,不同的 OS 有不同的价格对应:os 月卡 季卡 半年卡 年卡 Android 1500 4200 8200 14800 ios 1800 5000 9000 16800 -
参数编码问题: 当参数中出现特殊字符时(#$ ^ & * + =),需要在原参数完成签名后,然后对参数进行 URL 编码,再构造请求;
-
下单成功问题: 下单是否成功需以 status 状态为准,status==0 为下单成功,下单成功后不可重复下单, 当下单出现价格不匹配问题(此情况调试好后不会出现),第二次下单建议更换订单号、更换价格重新下单。
-
电信联名卡VIP下单请求参数
电信联名卡下单需要请求参数需要包含如下信息:
goodsType=3 购买VIP
goodsNum=1 购买一个月
originalTotalFee 电信与懒人协商的价格
例:
phoneNum=18895162342&outOrderNum=DX124563525632&goodsType=3&goodsNum=1&originalTotalFee=1000
含义:
18895162342的电信联名卡用户以10元的价格购买1个月的VIP会员,对于到电信那边的订单号是:DX124563525632