话费充值接口文档

接口版本：1.0

―、引言

1. • 文档概述

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

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

1. • 阅读对象

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

1. • 业务流程

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

1. 点击添加店铺，只勾选CMS即可，或者店铺ID保存。

1. 联系客服申请 app_key与app_secret 。

1. 开发对接，需求在控制台进行预存。

二、话费充值接口

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

网关URL：https://router.wikeyun.cn/rest/Recharge/pushOrder

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

失败返回数据格式：

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

成功返回数据格式：

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

2、回调通知

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

次回调。

3、查询接口（post 表单提交）

网关URL：https://router.wikeyun.cn/rest/Recharge/query

失败返回数据格式：

{"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. • 油卡充值接口

1、添加充值卡

网关URL：https://router.wikeyun.cn/rest/Oil/addCard

2、编辑充值卡

网关URL：https://router.wikeyun.cn/rest/Oil/editCard

3、油卡详情/删除

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

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

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

网关URL：https://router.wikeyun.cn/rest/Oil/pushOrder

失败返回数据格式：

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

成功返回数据格式：

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

3、回调通知

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

次回调。