创建订单

POST

https://openapi-cn01.tange365.com/v2/cloud-payment/order/create

/v2/cloud-payment/order/create

！！开发者需要用户完成支付的场景下才用到此接口。
使用步骤：
1.调用此接口创建待支付的订单
2.去第三方平台下单
3.引导用户支付
4.用户支付成功，调用接口完成订单
备注：如果创建的是4G流量订单，平台会检查4G卡是否有效（如果卡过期则返回创建失败）；如果创建的是4G大流量云存订单，平台将检查卡是否支持大流量云存（如果卡不支持则返回创建失败）

请求参数

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Signed-Headers

string

必需

参与计算签名的header字段。POST等请求传入content-length;content-type;x-tg-app-id;x-tg-date，GET请求传入x-tg-app-id;x-tg-date

默认值:

x-tg-app-id;x-tg-date

示例值:

content-length;content-type;x-tg-app-id;x-tg-date

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

X-Tg-Content-Sha256

string

必需

将BODY数据进行SHA256计算后的值

X-Tg-Algorithm

string

必需

目前服务端接口使用的签名算法的版本号和哈希算法

默认值:

TGV1-HMAC-SHA256

Content-Type

string

必需

默认值:

application/json

Content-Length

string

必需

Body的字符串长度

Body 参数application/json

device_id

string

设备ID

必需

设备ID，iccid二选一

service_id

integer

套餐ID

必需

trade_no

string

商户侧订单号

可选

开发者侧的订单号，关联探鸽的订单，对探鸽无实际用途

user_id

integer

用户ID

可选

购买云存储套餐的用户ID(设备归属账号)

remark

string

备注

可选

payment_method

string

支付方式

可选

iccid

string

物联网卡号

必需

设备ID，iccid二选一

示例

{
  "device_id": "{{device_id_82}}",
  "service_id": "1000008",
  "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 'https://openapi-cn01.tange365.com/v2/cloud-payment/order/create' \
--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": "1000008",
    "trade_no": "{% mock '\''integer'\'', 1, 9007199254740991 %}",
    "immediate_use": false,
    "user_id": 34,
    "remark": "aaa"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

非200表示出错

msg

string

错误描述

必需

data

object

数据

必需

merchant_number

string

平台订单号

必需

示例

{
  "code": 0,
  "msg": "string",
  "data": {
    "merchant_number": "string"
  }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-04-17 08:29:01

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

完成订单