Linksfield Developer
OverviewCube APIs旧版本API
OverviewCube APIs旧版本API
  1. Vshop
  • CSSS APIs
    • 全局说明/Overview
    • 国际化/ Internationalization
    • 状态码/Status code
    • 签名代码示例 / Sign code Example
    • SIM
      • 批量获取拥有的设备信息/Get all SIM cards info
      • 查询单一设备实时信息/Get real-time info about one SIM card
      • 同步使用中SIM卡信息/Get the SIM Cards in use
    • Usage
      • 查询单张SIM卡流量使用情况/ Example Query the traffic usage of a single SIM card
      • 批量查询SIM卡流量接口 /Batch querying SIM card usage
      • 查询单日流量使用情况 / Example Query the daily usage
      • 批量查询指定月份的流量使用情况/ Batch querying the usage in a specified month
    • Plan
      • 同步资费套餐 / Get data plan
      • 订购流量套餐/ Order data plan
      • 批量订购套餐/ Bulk order package
      • 续订流量套餐/ Renew your data plan
      • 查询套餐订单信息 / Query the package order information
      • 开通/启用流量套餐订单 / To enable the order
      • 取消流量套餐订单/ Cancel an unenabled package order
      • 提前结束设备套餐订单/ End package orders early
      • [不推荐]停机/暂停流量套餐订单
      • [不推荐]复机/重新启动流量套餐订单
      • 【不推荐】分页批量(查询)同步设备可订购套餐
    • SMS
      • 发送短信/ send SMS
    • Customized
      • OTA日套餐下单/Order OTA Plan
      • 运营商侧剩余流量查询/Query the remaing data by MNO side
  • Notification
    • Notification全局说明
    • Notification状态码
    • 流量使用量API预警
      POST
    • 短信下行回调
      POST
    • 短信上行回调
      POST
    • 短信上行回调(区分文本二进制)
      POST
    • 订单状态变更回调(IMSI)
      POST
  • Mall APIs
    • Mall全局说明
    • Mall业务流程
    • Mall签名代码示例
    • APP调用Stripe的SDK示例说明
    • Vshop
      • 卡片登录验证
        POST
      • 获取可购套餐商品列表
        POST
      • 创建用户订单
        POST
      • 查询正在使用、未启用订单
        POST
      • 获取生效中的自动续费
        POST
      • 关闭自动续费
        POST
      • 用户下单(第三方支付)
        POST
    • Payment
      • 获取stripe单次支付权限
      • 获取Stripe订阅支付权限
      • 创建Stripe订阅/自动续费
      • 支付结果查询
    • Notification
      • 消息推送
  • eSIM QR Mall APIs
    • Introduction
    • Pre - order
    • webhook
    • 用户登录
    • My eSIM Detail
  1. Vshop

创建用户订单

Cube UAT
https://api-uat.io.linksfield.net/cube/v4
Cube UAT
https://api-uat.io.linksfield.net/cube/v4
POST
/singleOrder

请求参数

Header 参数
Content-Type
string 
可选
默认值:
application/json
Body 参数application/json
autoRenewal
string 
必需
自动续费标志:1-开(有自动续费功能);0-关(没有自动续费功能);默认为0就是没有自动续费功能 ,
deviceCode
string 
必需
用户设备设备码(iccid/imei号)
languageCode
string 
必需
语言编码:0- 汉语(中文);1- 英语;2- 西班牙语;3- 法语4- 葡萄牙语;5- 印度语;6- 德语;7-日语;8- 韩语;9- 阿拉伯语;10-台湾繁中;11-港体繁中;12-俄语
mark
string 
必需
卡片归属标识:0-归属领科(当为此值时卡片需要通过领科企业卡片有效性的验证);1-不归属领科(当为此值时卡片不需要通过领科企业卡片有效性的验证);默认标识传0(归属领科),如果打开H5时携带此参数以实际为准。此字段不可传空字符串
orderNo
string 
必需
调用方自行生成,用来标识单独的一个订单编号
orderPeriod
string 
订购周期
必需
packageCode
string 
资费套餐编码
必需
partnerCode
string 
渠道编码
必需
payAmount
string 
订单支付总额
必需
payCurrency
string 
支付货币代码
必需
payId
string 
必需
支付ID 。 payId生成规则 : 企业编号+ 年月日+小时+分钟+秒+毫秒+2位随机数
requestOrderId
string 
外部渠道客户订单号
必需
servicePlanCode
string 
套餐商品编号
必需
servicePlanShowName
string 
套餐商品名称
必需
sign
string 
请求签名
必需
terminal
string 
必需
终端设备标识:0-移动终端;1-pc。此字段不可传空字符串
tradeTime
string 
访问时间戳
必需
tradeType
string 
接口名称
必需
version
string 
必需
接口版本,本次接口值为:3.0
示例
{
    "autoRenewal": "0",
    "deviceCode": "89860220190905123941",
    "languageCode": "0",
    "mark": "0",
    "orderNo": "2020061214140465562",
    "orderPeriod": "1",
    "packageCode": "PACKAGE20180428000007",
    "partnerCode": "P000818",
    "payAmount": "4.99",
    "payCurrency": "USD",
    "payId": "P0008182020061214140465562",
    "requestOrderId": "000000000001",
    "servicePlanCode": "string",
    "servicePlanShowName": "string",
    "sign": "b2a9e697bdff66049803d62ffeffccaf",
    "terminal": "0",
    "tradeTime": "20181031256548",
    "tradeType": "verify",
    "version": "3.0"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-uat.io.linksfield.net/cube/v4/singleOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "autoRenewal": "0",
    "deviceCode": "89860220190905123941",
    "languageCode": "0",
    "mark": "0",
    "orderNo": "2020061214140465562",
    "orderPeriod": "1",
    "packageCode": "PACKAGE20180428000007",
    "partnerCode": "P000818",
    "payAmount": "4.99",
    "payCurrency": "USD",
    "payId": "P0008182020061214140465562",
    "requestOrderId": "000000000001",
    "servicePlanCode": "string",
    "servicePlanShowName": "string",
    "sign": "b2a9e697bdff66049803d62ffeffccaf",
    "terminal": "0",
    "tradeTime": "20181031256548",
    "tradeType": "verify",
    "version": "3.0"
}'

返回响应

🟢200成功
application/json
Body
deviceCode
string 
必需
用户设备设备码(iccid/imei号)
orderNo
string 
必需
调用方自行生成,用来标识单独的一个订单编号
partnerCode
string 
渠道编码
必需
payId
string 
支付ID
必需
示例
{
    "deviceCode": "89860012018111220455",
    "orderNo": "2020061214140465562",
    "partnerCode": "P000270",
    "payId": "P0008182020061214140465562"
}
修改于 2023-06-12 07:50:08
上一页
获取可购套餐商品列表
下一页
查询正在使用、未启用订单
Built with