订单提交接口

简要描述：

提交订单接口

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

请求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 商品模板中key 类型 是否必填 描述 示例值
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

返回示例：

{
    "code": 200,
    "msg": "下单成功",
    "data": {
        "ordersn": "API091952652791532879872",
        "external_orderno": "D091952644768932429824",
        "total_price":1
    }
}

返回data说明：

参数名 类型 描述
ordersn string 本地订单号
external_orderno string 三方订单号
total_price string 订单金额