订单提交接口

简要描述:

提交订单接口

  1. POST请求,Content-Type必须设置为:application/json;
  2. 接口是异步,接口调用成功(即下单成功),不代表充值成功
  3. 最终“充值结果”,需要调用“订单详情接口”进行查询,由于取卡是异步操作,建议间隔1-3s循环调用,直至最终结果;
  4. 此接口不会返回卡密数据,需要再调用“订单详情接口”获取卡密信息;
  5. “订单详情接口”必须接入;
  6. 下单接口如果请求超时,请调用订单详情接口确认下单结果;

请求URL:

http(s)://平台域名/api/v1/order/buy

请求方式:

POST

请求参数:

Header 参数 类型 是否必填 描述 示例值
Sign string 签名 点击查看签名规范
Timestamp string 13位时间戳(毫秒) 1696644296195
UserId string 您的用户接口appid 2uIkTrXNdAFc7OKhbRenzjDtgPoZ6s5C
Body 参数 类型 是否必填 描述 示例值
id int 商品ID 1
url string 订单回调地址(没有就不传) http://demo.kasushou.com/notify
external_orderno string 三方订单号(防重复)可传空,建议传值,需传唯一值 D091952644768932429824
safe_price string 安全价格(防止调价导致亏本,传入此参数用于对比) 2.2
mark string 下单备注  
quantity int 下单数量 1
attach object 下单参数(卡密商品不用传此参数) 手工订单下单模板(以下属性为商品模板中key)
attach 参数 类型 是否必填 描述 示例值
recharge_account string 充值账号 111111
lblName1 string 下单参数一 222222
lblName2 string 下单参数二 333333
下单参数N 123456

签名示例:

1696644296195{"attach:{"recharge_account":"111111","lblName1":"222222","lblName2":"333333"},"external_orderno":"D091952644768932429824","id":1,"mark":"","quantity":1,"safe_price":"2.2","url":"http://demo.kasushou.com/notify"}apikey

返回示例:

  1. {
  2. "code": 200,
  3. "msg": "下单成功",
  4. "data": {
  5. "ordersn": "API091952652791532879872",
  6. "external_orderno": "D091952644768932429824"
  7. }
  8. }

返回data说明:

参数名 类型 描述
ordersn string 本地订单号
external_orderno string 三方订单号
© 版权声明
THE END
喜欢就支持一下吧
点赞12 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容