卡速售2.0API - 订单提交接口

订单提交接口

#### **简要描述：**
提交订单接口

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

#### **请求URL：**

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

#### **请求方式：**

`POST`

#### **请求参数：**

| Header 参数 | 类型 | 是否必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| Sign | string  | 是 |签名 |[ 点击查看签名规范](https://doc.kasushou.com/api/v2api/39 " 点击查看签名规范") |
| 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`

#### **返回示例：**
```php
{
    "code": 200,
    "msg": "下单成功",
    "data": {
        "ordersn": "API091952652791532879872",
        "external_orderno": "D091952644768932429824"
    }
}
```
#### **返回data说明：**
| 参数名 | 类型  | 描述 |
| --- | --- | --- |
| ordersn | string | 本地订单号 |
| external_orderno | string  | 三方订单号 |

</br></br></br></br>