用户续费提交

典型场景

将到期卡续费操作,提交完成1小时后请前往平台确认订单付款,平台路径:订单中心 -> 卡续费订单 -> 待付款

每小时收集聚合生成订单和处理订单;

通过接口确认续费流程:通过“待付款卡续费订单查询”接口,得到付款订单 -> 通过“待付款卡续费订单操作”确认订单付款;

接口功能

提交卡续费操作

变更记录

接口版本

更新时间

更新人

更新说明

1.0.0

2020-11-25

卫黄庭

用户续费提交接口

接口原型

请求类型

POST

请求地址

https://api.tibiot.cn/api/v1/renew/submit

传输协议

HTTP

Content-Type

application/json

接口说明

1、1分钟内提交不能超过1000次;
2、同张卡每月只能提交一次;
3、销户中的不可提交;
4、续费中的不可提交;
5、变更中的不可提交;
6、卡到期日期为近12个月内的才可提交;

请求参数

参数

是否必填

类型

示例

描述

userName

String

zhangsan

用户名

passWord

String

123456

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

tKey

String

20181019130530

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

iccid

String

89860412101871055784

iccid(19、20)位

duration

int

12

续费时长,非必填,月默认12月 其余周期默认1

methodFlag

String

submit

用途标识,区分大小写,默认(包含传错)为,submit;
submit :传值为提交续费;
query :传值为查询是否可提交;

请求示例

响应示例

成功:

失败:

响应参数

参数

类型

示例

描述

status

int

0

返回状态

message

String

成功

返回信息

data

String

202011171512089395726

当methodFlag =“submit”时,返回值用于查询续费订单是否生成的结果时使用编号,不是续费订单号;
当methodFlag=“query”时,返回值为“1”为可提交续费,否,则为不可提交续费;