卡速售2.0API
首页
官网
社区
商户中心
平台简介
开发指南
签名规范
全局状态码
基础数据
用户余额查询
商品接口
商品分类列表
商品列表接口
商品详情接口
商品调价记录
订单接口
提交订单接口
订单查询接口
订单异步回调
后台接口
获取订单接口
处理订单接口
用户加款接口
提交订单接口
#### **简要描述:** 提交订单接口 ```xml POST请求,Content-Type必须设置为:application/json; 接口是异步,接口调用成功(即下单成功),不代表充值成功 最终“充值结果”,需要调用“订单详情接口”进行查询,由于取卡是异步操作,建议间隔1-3s循环调用,直至最终结果; 此接口不会返回卡密数据,需要再调用“订单详情接口”获取卡密信息; “订单详情接口”必须接入; 下单接口如果请求超时,请调用订单详情接口确认下单结果; ``` #### **请求URL:** `http://平台域名/api/v1/order/buy` #### **请求方式:** `POST` #### **请求参数:** | Header 参数 | 类型 | 是否必填 | 描述 | 示例值 | | --- | --- | --- | --- | --- | | Sign | string | 是 |签名 |[ 点击查看签名规范](https://doc.kasushou.com/api/v2api/39 " 点击查看签名规范") | | Timestamp | string | 是 | 13位时间戳(毫秒) | 1696644296195 | | UserId | string | 是 | 您的用户编号 | 10000 | | 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` #### **返回示例:** ```php { "code": 200, "msg": "下单成功", "data": { "ordersn": "API091952652791532879872", "external_orderno": "D091952644768932429824" } } ``` #### **返回data说明:** | 参数名 | 类型 | 描述 | | --- | --- | --- | | ordersn | string | 本地订单号 | | external_orderno | string | 三方订单号 | </br></br></br></br>