购买套餐（创建并完成订单）

POST

/v2/cloud-payment/order

创建、完成订单的原子操作
备注：如果创建的是4G流量订单，平台会检查4G卡是否有效（如果卡过期则返回创建失败）
如果创建的是4G大流量云存订单，平台将检查卡是否支持大流量云存（如果卡不支持则返回创建失败）

请求参数

Header 参数

Body 参数application/json

示例

{
    "device_id": "{{device_id_82}}",
    "service_id": "1010008",
    "trade_no": "{% mock 'integer', 1, 9007199254740991 %}",
    "immediate_use": false,
    "user_id": 34,
    "remark": "aaa"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/cloud-payment/order' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'Authorization;' \
--header 'X-Tg-Signed-Headers;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-Content-Sha256;' \
--header 'X-Tg-Algorithm;' \
--header 'Content-Length;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_id": "{{device_id_82}}",
    "service_id": "1010008",
    "trade_no": "{% mock '\''integer'\'', 1, 9007199254740991 %}",
    "immediate_use": false,
    "user_id": 34,
    "remark": "aaa"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "merchant_number": "20190520160646984088060",
        "order_id": 51
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-04-17 08:28:15

对已开通套餐的生效顺序排序

创建订单