应用场景
商户在其前端页面输入电费号和日期,由商户网页或者商户后台调用该接口发起缴电费。
接口地址
219.136.207.190:9991
输入参数
采用SOCKET协议通信,报文格式采用拼接字符串的形式,具体格式如下:
客户号#账单日期#缴费月数#总电费#客户名称#操作员号#第三方流水号
缴费 | ||||
---|---|---|---|---|
含义 | 功能说明 | 长度 | 备注 | |
客户号 | 必输 | 16 | 用户电费号 | |
账单日期 | 必输 | 6 | 单月,如201005;多月,999999 | |
缴费月数 | 必输 | 1 | 默认值1 | |
总电费 | 必输 | 16 | 单位:分,保留两位小数。单月,单月总金额;多个月单月总金额汇总 | |
客户名称 | 必输 | 64 | ||
操作员号 | 必输 | 30 | 第三方为商户号 | |
第三方流水号 | 必输 | 30 |
举例如下:
0800140017551234#201703#1#42484#小米#EGZTH042#00134840401234
返回结果
数据按拼接字符串格式实时返回:
账单日期#缴费月数#总电费#订单号#电力局流水号#区域ID
缴费 | ||||
---|---|---|---|---|
含义 | 功能说明 | 长度 | 备注 | |
账单日期 | 16 | |||
缴费月数 | 1 | 默认值1 | ||
总电费 | 16 | 单位:分,保留两位小数 | ||
订单号 | 16 | |||
电力局流水号 | 24 | 注意:电力局返回流水号长度,新接口有变长 | ||
业务ID | 4 |
举例如下:
201703#1#42484#1435263#201703160800000033123456#1021
响应码
返回类别 | 返回编码 | 说明 |
---|---|---|
成功 | 0 | 成功 |
参数错误 | 1001 | 参数错误 |
非本系统终端 | 1002 | 非本系统终端 |
签名不正确 | 1003 | 此终端已列入黑名单 |
报文发送电力失败 | 1004 | 报文发送电力失败 |
电力返回空 | 1005 | 电力返回空 |
供电返回不完整 | 1006 | 供电返回不完整 |
供电返回错误信息 | 1007 | 供电返回错误信息 + 数据 |
流水号不一致 | 1008 | 流水号不一致 |
系统故障 | 1582 | 系统故障 |
签名不正确 | 1009 | 签名不正确 |
金额不符 | 1010 | 金额不符 |
余额不足 | 1011 | 余额不足 |
系统生成订单失败 | 1012 | 系统生成订单失败 |
扣费失败 | 1013 | 扣费失败 |
连接供电局失败 | A1 | 连接供电局失败 |
发送电力失败 | A2 | 发送电力失败 |
其他错误 | ER | 错误信息 |