订单

订单

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

确认订单信息

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

创建订单

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

支付

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及以上

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 支付

响应

成功响应Trade结构体

Trade

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

错误

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

results matching ""

    No results matching ""