接入指引

接入流程

提供公司信息
公司名
公司电话
公司邮箱
营业执照注册号

开通测试平台应用

测试平台开发和验收

切换正式平台

接口说明

参数

接口固定参数 app_id（应用 id） sign（签名）timestamp（Unix 时间戳），所有接口请求的时候都要携带。
金额单位统一为分

签名

请求参数签名

筛选：获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign参数。

排序：将筛选的参数按照第一个字符的键值 ASCII 码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值 ASCII 码递增排序，以此类推。

拼接：将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。将待签名字符串和商户私钥带入 sha256 算法中得出 sign，最终生成的字节数组需要转换成 16 进制字符。

签名步骤
请求参数：device_num=19285526&device_port=2&is_error=true&app_id=3a7030ea45a08d&timestamp=1644902382
待签名内容：app_id=3a7030ea45a08d&device_num=19285526&device_port=2&is_error=true&timestamp=1644902382
签名：
$sppSecret="17b0215450f31f9f9107da49e68d8b58";
$sign="26a84d3b5f01e414e273e70d7ec33971306562d004887dd517d872cfcd4e23cb";
hash_hmac("sha256", $strToSign, $appSecret);
请求后如果签名错误，会返回待签名的字符串，方便核对参数排序和拼接问题

接口对接顺序

添加设备（必须先调用该接口将设备和 app_id 绑定）

充电回调（需要提供回调地址）

回调

提供回调网址如：https://charge.iot.com/api/callback

请求开始充电，开放平台会将开始充电结果回调到https://charge.iot.com/api/callback/start_power

设备结束充电，开放平台会将结束订单信息回调到https://charge.iot.com/api/callback/finish_order

业务流程

开始充电

结束充电

业务端主动结束充电时序图如下所示，设备主动结束（充满断电、时间用完、金额用完、故障、异常等）也会触发订单结束回调。

产品说明

设备类型

产品名对应的设备类型

产品名	设备类型（枚举值）	端口数
T-W1、T-C2、T-W2、T-A2、T-W20	普通慢充款（0）	10
X-S2、T-A3、天猫 T-A3、X-S20、L2 架子	功率慢充款（1）	10
X-S1	电量款20（5）	10
X-S3	功率款10（4）	10
X-S6	功率款10C（11）	10
T-W6	普通功率款（8）	10
D-N2	两路功率慢充款（6）	2
D-N3 网关、节点	LoRa 网关、节点（9、10）	2
D-N5	两路功率款10A（19）	2
电容 A 款、普通双路、数码双路、S-KC2、S-KC1	快充款（3）	2

接入流程#

接口说明#

参数#

签名#

接口对接顺序#

回调#

业务流程#

开始充电#

结束充电#

产品说明#

设备类型#

接入流程

接口说明

参数

签名

接口对接顺序

回调

业务流程

开始充电

结束充电

产品说明

设备类型