电费充值API接口,支持国家电网/南方电信

 更新时间:2021-10-16 22:52:10   作者:佚名   我要评论(0)

话费充值接口文档接口版本:1.0 ―、引言1.1 文档概述本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成

话费充值接口文档

接口版本:1.0

 

―、引言

1.1 文档概述

本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成接口开发与联调,实现与话费充值系统的交易互联。

公司官网http://www.wikeyun.cn/

 

1.2 阅读对象

本文阅读对象:开发人员与微客云系统对接支付相关的技术人员。

 

1.3 业务流程

1、打开控制台 https://control.wikeyun.cn/ 进行注册账号

2、点击添加店铺只勾选CMS即可或者店铺ID保存

3、联系客服申请 app_key与app_secret

4、开发对接需求在控制台进行预存

 

二、话费充值接口

1、充值请求下单post 表单提交

URL:https://router.wikeyun.cn/rest/Recharge/pushOrder

 

参数名

类型

必填

参数说明

store_id

字符串

店铺ID

mobile

字符串

充值号码

order_no   

字符串

充值订单号

money

整数

充值金额(100,200)

recharge_type

整型

1快充 0慢充

notify_url

字符串

异步回调地址(POST)

change

整数

失败更换渠道充值 0  1

不传系统根据设置判断

source

整形

是否强制渠道

注意因为每个渠道价格不同不同用户提交的业务不同默认不强制

source字段则可以强制某渠道强制快充走94折则source传6

败返回数据格式:

{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}

成功返回数据格式:

{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}

 

 

 

2、回调通知

 

参数名

类型

参数说明

order_no

字符串

充值订单号

order_number

字符串

官方订单号

status

字符串

交易结果(0 待支付 1 已付 充值中 2充值成功 3充值失败 需要退款 4退款成功 6待充值 7 已匹配

收到回调后,商户必须同步返回字符串 success,否则平台认为商户没有收到回调,会重复发送5

次回调。

 

3、查询接口post 表单提交

URL:https://router.wikeyun.cn/rest/Recharge/query

 

参数名

类型

必填

参数说明

order_number

字符串

官方订单号

败返回数据格式:

{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}

成功返回数据格式:

{"code":"0000","msg":"获取成功","data":{"order_number":"xxxx","status":"1","mobile":"13786517891","amount":"100","order_no":"xxxx"}}

4、查询余额接口post 表单提交

URL:https://router.wikeyun.cn/rest/User/query

 

数据格式:

{"code":"0000","msg":"获取成功","data":{"money":"100","id":1234}}

 

三、油卡充值接口

 

1、添加充值卡

URL:https://router.wikeyun.cn/rest/Oil/addCard

 

参数名

类型

必填

参数说明

store_id

字符串

店铺ID

card_num

字符串

充值卡号

name

字符串

姓名

phone

字符串

手机号

user_num

             字符串

身份证

card_type

整数

0中石化 1中石油

2编辑充值卡

URL:https://router.wikeyun.cn/rest/Oil/editCard

 

参数名

类型

必填

参数说明

card_id

字符串

卡ID

card_num

字符串

充值卡号

name

字符串

姓名

phone

字符串

手机号

user_num

             字符串

身份证

card_type

整数

0中石化 1中石油

3油卡详情/删除

删除URL:https://router.wikeyun.cn/rest/Oil/delCard

详情URL:https://router.wikeyun.cn/rest/Oil/cardInfo

 

参数名

类型

必填

参数说明

card_id

字符串

卡ID

 

2、充值下单请求post 表单提交

URL:https://router.wikeyun.cn/rest/Oil/pushOrder

 

参数名

类型

必填

参数说明

store_id

字符串

店铺ID

cardId

整数

充值卡ID,来自创建接口

order_no   

字符串

充值订单号

amount

整数

充值金额(500)

recharge_type

整型

1快充 0慢充目前请传0

notify_url

字符串

异步回调地址(POST)

败返回数据格式:

{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}

成功返回数据格式:

{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}

   

3、回调通知

 

参数名

类型

参数说明

order_no

字符串

充值订单号

order_number

字符串

官方订单号

status

字符串

交易结果(0 待支付 1 已付 充值中 2充值成功 3充值失败 需要退款 4退款成功 6待充值 7 已匹配

收到回调后,商户必须同步返回字符串 success,否则平台认为商户没有收到回调,会重复发送5

次回调。

 

4、查询接口post 表单提交

URL:https://router.wikeyun.cn/rest/Oil/query

 

参数名

类型

必填

参数说明

order_number

字符串

官方订单号

败返回数据格式:

{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}

成功返回数据格式:

{"code":"0000","msg":"获取成功","data":{"order_number":"xxxx","status":"1","mobile":"13786517891","amount":"100","order_no":"xxxx"}}

 

四、电费充值接口

 

1、添加充值卡

URL:https://router.wikeyun.cn/rest/Power/addCard

 

参数名

类型

必填

参数说明

store_id

字符串

店铺ID

card_num

字符串

充值账号

province

字符串

省份,不带省字比如江苏

city

字符串

城市,不带市字比如南京

remark

             字符串

备注

type

整数

0国家电网 1南方电信

2、编辑充值卡

URL:https://router.wikeyun.cn/rest/Power/editCard

 

参数名

类型

必填

参数说明

card_id

字符串

卡ID

card_num

字符串

充值账号

province

字符串

省份,不带省字比如江苏

city

字符串

城市,不带市字比如南京

remark

             字符串

备注

type

整数

0国家电网 1南方电信

3、电费详情/删除

删除URL:https://router.wikeyun.cn/rest/Power/delCard

详情URL:https://router.wikeyun.cn/rest/Power/cardInfo

 

参数名

类型

必填

参数说明

card_id

字符串

卡ID

 

2、充值下单请求post 表单提交

URL:https://router.wikeyun.cn/rest/Power/pushOrder

 

参数名

类型

必填

参数说明

store_id

字符串

店铺ID

cardId

整数

充值卡ID,来自创建接口

order_no   

字符串

充值订单号

amount

整数

充值金额(500)

recharge_type

整型

1快充 0慢充目前请传0

notify_url

字符串

异步回调地址(POST)

败返回数据格式:

{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}

成功返回数据格式:

{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}

   

3、回调通知

 

参数名

类型

参数说明

order_no

字符串

充值订单号

order_number

字符串

官方订单号

status

字符串

交易结果(0 待支付 1 已付 充值中 2充值成功 3充值失败 需要退款 4退款成功 6待充值 7 已匹配

收到回调后,商户必须同步返回字符串 success,否则平台认为商户没有收到回调,会重复发送5

次回调。

 

4、查询接口post 表单提交

URL:https://router.wikeyun.cn/rest/Oil/query

 

参数名

类型

必填

参数说明

order_number

字符串

官方订单号

败返回数据格式:

{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}

成功返回数据格式:

{"code":"0000","msg":"获取成功","data":{"order_number":"xxxx","status":"1","mobile":"13786517891","amount":"100","order_no":"xxxx"}}

 

 

五、签名算法

 

1、系统参数

以下参数必须传参全部采用get传参(拼接至url内),系统参数包括

参数名

类型

参数说明

app_key

字符串

应用唯一表示

timestamp

字符串

unix时间戳秒单位

client

字符串

客户端请求ip

v

字符串

客户端接口版本目前是1.0

format

字符串

默认json

sign

字符串

sign签名

2、sign签名算法

把业务参数+系统参数合并成一个数组然后对数组进行ksort排序(ASCII由小到大排序),然后对合并后的数组进行循环拼接格式如下key1value1key2value2key3value3的形式拼接最终首尾各拼接一个app_secret,对最终字符串进行md5大写加密

3、sign案例

最终拼接完成的URL如下https://router.wikeyun.cn/rest/Recharge/pushOrder?app_key=1037110417×tamp=1624862089&client=127.0.0.1&format=json&v=1.0&sign=831EFFE3A7A59A530DA8CEC4A05D744

然后对上面的url 进行post传业务参数

 

附录

1、充值请求code 状态码

 

0000

接口成功

1003

app_key不存在

1004

业务错误具体看msg

1005

sign签名不对

1006

timestamp Out

1007

应用已禁用

1008

余额不足

1009

相同面值太多,请拆分充值或者稍后再试

 

注意事项话费快充

1、请勿同一时间段推送大量订单。

2、请勿推送大量相同面值的订单,比如全是50,全是100,又或者50,100相间有规律的金额

3、系统会严格审核充值金额,同时出现多个金额相同的单子,就会返回1009失败,请稍后再试或者拆分提交处理。


相关文章

  • 电费充值API接口,支持国家电网/南方电信

    电费充值API接口,支持国家电网/南方电信

    话费充值接口文档接口版本:1.0 ―、引言1.1 文档概述本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成
    2021-10-16
  • Python rindex()方法案例详解

    Python rindex()方法案例详解

    描述 Python rindex() 方法返回子字符串最后一次出现在字符串中的索引位置,该方法与 rfind() 方法一样,只不过如果子字符串不在字
    2021-10-13
  • vue uniapp实现分段器效果

    vue uniapp实现分段器效果

    本文实例为大家分享了vue uniapp实现分段器效果的具体代码,供大家参考,具体内容如下 此举只是记录下用vue动态改变样式效果 先展示下效果
    2021-10-13
  • Java 全面掌握网络编程篇

    Java 全面掌握网络编程篇

    目录计算机网络网络模型客户机服务器模式(Client/Server)TCP/IP的概念和实现TCP三次握手(Three-way handshake)TCP编程UDP的概念和实现UDP编程
    2021-10-13
  • @JsonSerialize不起作用的解决方案

    @JsonSerialize不起作用的解决方案

    目录@JsonSerialize不起作用在项目中 当字段实体类为Long类型时但是这里有个小坑@JsonSerialize正确使用1. 写一个负责转换的类2. 在实体类上
    2021-10-13
  • 深入解析MySQL索引数据结构

    深入解析MySQL索引数据结构

    目录概述索引数据结构二叉树 红黑树 B-Tree B+Tree Hash 索引InnoDB 索引实现(聚集) 索引文件和数据文件是分离的(非聚集) 聚集索
    2021-10-13
  • 十分钟上手正则表达式 上篇

    十分钟上手正则表达式 上篇

    目录一、正则表达式的定义:二、正则表达式的类型三、定义 BRE 模式3.1 纯文本3.2 特殊字符3.3 锚字符3.3.1 锁定在行首3.3.2 锁定在行尾3.3.
    2021-10-13
  • Python爬虫实战JS逆向AES逆向加密爬取

    Python爬虫实战JS逆向AES逆向加密爬取

    目录爬取目标工具使用项目思路解析简易源码分享爬取目标 网址:监管平台 工具使用 开发工具:pycharm 开发环境:python3.7, Windows10 使用
    2021-10-13
  • 使用Swagger实现接口版本号管理方式

    使用Swagger实现接口版本号管理方式

    目录Swagger实现接口版本号管理使用swagger测试接口Swagger实现接口版本号管理 前言:使用swagger暴露对外接口时原则是每个系统在不同的迭代
    2021-10-13
  • Java数据结构实现二维数组与稀疏数组转换详解

    Java数据结构实现二维数组与稀疏数组转换详解

    基本介绍 当一个数组中大部分元素为0,或者为同一个值的数组时,可以使用稀疏数组来保存该数组。 稀疏数组的处理方法是: ①记录数组一共有
    2021-10-13

最新评论