提交订单接口-晓晓权益 - API接口开发文档

简要描述：

提交订单接口

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	否	订单回调地址（没有就不传）	https://hy.ziyuanting.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":"https://hy.ziyuanting.com/notify"}apikey

返回示例：

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

返回data说明：

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