Enterprise Gateway (CN) -v3+v4 link
  1. Vshop
Enterprise Gateway (CN) -v3+v4 link
  • 历史版本API
    • Mall APIs
      • Mall全局说明
      • Mall业务流程
      • Mall签名代码示例
      • APP调用Stripe的SDK示例说明
      • Vshop
        • 卡片登录验证
          POST
        • 获取可购套餐商品列表
          POST
        • 创建用户订单
          POST
        • 查询正在使用、未启用订单
          POST
        • 获取生效中的自动续费
          POST
        • 关闭自动续费
          POST
      • Payment
        • 获取stripe单次支付权限
        • 获取Stripe订阅支付权限
        • 创建Stripe订阅/自动续费
        • 支付结果查询
  • 草稿
    • 查询自动续费记录
      POST
  1. Vshop

创建用户订单

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://apiv3.linksfield.net/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