单卡变更套餐提交

典型场景

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

接口功能

提交单卡套餐变更

变更记录

接口版本

更新时间

更新人

更新说明

1.0.0

2022-11-03

邓双玲

单卡变更套餐提交

接口原型

请求类型

POST

请求地址

https://api.tibiot.com/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. 立即变更（支持各计费周期之间的变更；处理完成后立即生效）
2. 次月生效（支持月变月，月变长周期的变更；处理完成后，移动电信从次月1日，联通从本月或次月27日生效）
3. 周期变更（支持长周期变长周期（同计费周期）；处理完成后，到期时间不变，次周期生效）
4. 到期变更（支持本月到期卡月变月，月变长周期的变更；处理完成后，到期生效）
高价变更低价不产生费用，低价变高价产生费用

buyTime

否

Int

12

购买时长，数值范围1-12，默认12; 若为长周期 默认为1； 当 changeType=1 或 =2 或=4 时，传值;

请求示例

1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
{
    "userName":"zhangsan",
    "passWord":"e10adc3949ba59abbe56e057f20f883e",
    "tKey":"20190625143828",
    "iccid":"1456325896745632589",
    "userPackageId":13,
    "changeType":1
}

响应示例

1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9
1
2
3
4
5
6
7
8
9

成功：

{
    "status":0,
    "message":"成功",
    "data":{
        "orderId":"202209210931563301407",
        "totalPrice":"0.00"
    }
}

失败：

{
    "status":99998,
    "message":"请求超限",
    "data":null
}
1
2
1
2
1
2
1
2
1
2
1
2

响应参数

参数

类型

示例

描述

status

int

0

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

message

String

成功

返回信息 失败为失败说明

data

orderId

String

202209210931563301407

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

totalPrice

String

0.00

总金额（元）