查询订单列表

GET

/v2/cloud-payment/orders

device_id、iccid、user_id参数三选一，如果都传了，只有其中一个有效。
优先级iccid > user_id > device_id

请求参数

Query 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/v2/cloud-payment/orders?device_id=1702D8OBYWWQ&iccid=89861121254089102741&user_id=101&offset=0&limit=10' \
--header 'X-Tg-Signed-Headers: x-tg-app-id;x-tg-date' \
--header 'X-Tg-Signed-Headers: x-tg-app-id;x-tg-date' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'X-Tg-Algorithm: TGV1-HMAC-SHA256' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: '

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "items": [
            {
                "order_id": 1,
                "merchant_number": "20190520160646984088060",
                "create_at": 1558339606,
                "payment_method": "Balance",
                "status": 2,
                "currency_code": "CNY",
                "device_id": "1702D8OBYWWQ",
                "iccid": "89861122241045896497",
                "user_id": 34,
                "fee_amount": 28
            },
            {
                "order_id": 2,
                "merchant_number": "20190520160646984088060",
                "create_at": 1558339606,
                "payment_method": "Balance",
                "status": 2,
                "currency_code": "CNY",
                "device_id": "1702D8OBYWWQ",
                "iccid": "89861122241045896497",
                "user_id": 34,
                "fee_amount": 28
            }
        ],
        "total": 22
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-01-15 04:58:00

取消套餐

查询订单