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