订单

订单

业务错误码统一前缀为:20

确认订单信息

  1. POST /order_info

权限

  • 需要认证用户
    参数
字段是否必填描述
targetType enum{course,classroom}是商品类型
targetId int string是商品ID
unit string否购买方式，year,month
num int string否购买数量

响应

成功响应OrderInfo结构体

OrderInfo

字段描述
targetType enum{course,classroom}商品类型
targetId int string商品ID
totalPrice float string商品价格
title string商品名称
account CashAccount当前用户的账户信息
hasPayPassword bool是否有支付密码
verifiedMobile string已经验证的手机号码
coinName string虚拟币名称
cashRate float string汇率
priceType enum{RMB,Coin}标价类型
coinPayAmount float string本单需要支付的虚拟币
maxCoin float string本单最高可以抵扣的虚拟币
availableCoupons list<Coupon>可以使用的优惠码
fullCoinPayable bool是否允许虚拟币全额支付
unitType enum{month,year}购买VIP,按月购买、按年购买
duration int string购买VI时长
buyType enum{new,renew,upgrade}VIP购买类型 new:购买,renew:续费,upgrade:升级

错误

Code错误说明HTTP状态码
9缺少参数422

创建订单

  1. POST /orders

权限

  • 需要认证用户
    参数
字段是否必填描述
targetType enum{course,classroom,vip}是商品类型
targetId int string是商品ID
couponCode string否优惠码
coinPayAmount int string否支付的虚拟币
payPassword string否如果使用虚拟币支付,需要用支付密码 使用XXTEA加密，key为EduSoho，然后再base64编码
unit enum{month,year}否按月购买、按年购买
num int string否购买会员时长
appPay string否是否唤起app支付，Y:唤起 N:不唤起，默认N
payment string否支付方式（'wechat'）

响应

成功响应

字段描述
id int string订单id
sn int string订单编号

错误

Code错误说明HTTP状态码
9缺少参数422
2001当前使用的账户金额大于账户余额500
2002支付密码不正确500

支付

  1. POST /pay_center

权限

  • 需要认证用户
    参数
字段是否必填描述
orderId int string是商品ID
targetType enum{course,classroom,vip}是购买商品类型
payment enum{alipay,coin}是支付方式

响应

成功响应

字段描述
id int string订单id
status enum{created,paid}订单状态
paymentForm string支付表单
paymentHtml string支付html
paymentUrl string支付链接

错误

Code错误说明HTTP状态码
9缺少参数422
2007支付方式未开启, 请先开启500

新的支付接口

版本8.2.0及以上

  1. POST /trades

权限

  • 需要认证用户
    参数
字段是否必填描述
gateway string}是支付网关
type enum{purchase,recharge}是交易类型,purchase: 购买, recharge: 充值
orderSn int string否订单Sn，只有购买类型才需要传递
coinAmount float string否虚拟币使用额
payPassword int string否支付密码，密码需要加密

gateway

  • WechatPay_Native: 微信扫码支付
  • WechatPay_MWeb: 微信 Wap 支付
  • WechatPay_Js: 微信内支付
  • Alipay_LegacyExpress: 支付包 Web 支付
  • Alipay_LegacyWap: 支付宝 Wap 支付
  • Lianlian_Web: lianlian Web 支付
  • Lianlian_Wap: lianlian Wap 支付
  • Coin: 纯虚拟币支付（app使用）
    响应

成功响应Trade结构体

Trade

字段描述
tradeSn int string交易sn
status enum{created,paid}支付状态

错误

Code错误说明HTTP状态码
7参数错误400
9缺少参数400
2000没有输入支付密码，不能使用虚拟币支付400
2001余额不足400
2002支付密码不正确400
2003优惠码已经被使用了400
2004订单不存在400
2005用户未登录，不能支付400
2006不是您的订单，不能支付400
2008支付密码未设置400
2009超过最大允许支付的虚拟币额度400
2010金额错误400
20007未开放购买400