订单提交接口

简要描述：

提交订单接口

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://shop.vysc.vip/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://shop.vysc.vip/notify"}apikey

返回示例：

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

返回data说明：

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

订单提交接口

简要描述：

请求URL：

请求方式：

请求参数：

签名示例：

返回示例：

返回data说明：

联系我们

400-696-1187