单卡变更套餐提交

典型场景

通过接口提交当前单卡可变更套餐；

接口功能

提交单卡套餐变更

变更记录

接口版本

更新时间

更新人

更新说明

1.0.0

2022-11-03

邓双玲

单卡变更套餐提交

接口原型

请求类型

POST

请求地址

https://api.tibiot.cn/api/v1/submitCardUpdatePackage

传输协议

HTTP

Content-Type

application/json

接口说明

接口限制：100/分钟；只适用于单卡套餐不可用于池卡；
提交过程中会计算应付金额，应付金额在提交成功后会从账号余额中扣除；

请求参数

参数

是否必填

类型

示例

描述

userName

是

String

zhangsan

用户名

passWord

是

String

123456

加密后密码,加密规则参照密码加密规则

tKey

是

String

20190625143828

当前时间,tKey生成规则参照tKey规则

iccid

是

注：iccid与msisdn(卡号)有且只能有一个

String

1456325896745632589

iccid（19、20）位

msisdn

String

125463285465

卡号（11、13、15）位

userPackageId

是

Int

15

变更后的用户资费包编号；通过查询单卡可变更套餐接口获取；

changeType

是

Int

1

变更类型
1. 次日变更 （不改变当前到期日期，高价变低价不产生费用，低价变高价补差价）
3. 套餐到期变更（在当前到期日期后延续，收取变更后套餐价格）

buyTime

否

Int

12

购买时长，数值范围1-12，默认12；当changeType=3时，传值；

请求示例

响应示例

成功：

失败：

响应参数

参数

类型

示例

描述

status

int

0

返回状态 0成功，非0失败

message

String

成功

返回信息 失败为失败说明

data

orderId

String

202209210931563301407

业务订单ID，可用于查询业务订单

totalPrice

String

0.00

总金额（元）