国家电网电费费充值api，油卡充值api

―、引言

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、添加充值卡

网关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	整数	是	充值金额（100的倍数）
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/Power/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"}}