―、引言

文档概述

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

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

阅读对象

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

1. 业务流程
打开控制台 https://control.wikeyun.cn/ 进行注册账号
点击添加店铺，只勾选CMS即可，或者店铺ID保存。
联系客服申请 app_key与app_secret 。
开发对接，需求在控制台进行预存。

二、话费充值接口

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

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

参数名	类型	必填	参数说明
store_id	字符串	是	店铺ID
mobile	字符串	是	充值号码
order_no	字符串	是	充值订单号
money	整数	是	充值金额（50,100,200）
recharge_type	整型	是	1快充 0慢充
notify_url	字符串	是	异步回调地址（POST）
change	整数	否	失败更换渠道充值 0 否 1是不传系统根据设置判断
source	整形	否	是否强制渠道

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

失败返回数据格式：

{"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中石油

三网话费充值优惠接口API分享相关推荐

个人微信开发协议sdk接口API分享
个人微信开发协议sdk接口API分享 1.基础消息类型 1.客户端发送的心跳包 HeartBeatReq = 1001; 2.消息接收确认回复(接收或拒绝接收) MsgReceivedAck = 10 ...
认知智能机器人接口API分享。非常好用，免费。
道翰天琼认知智能未来机器人接口API简介介绍最近在寻找一个机器人接口.每个需要的时候,它总会适时的出现,且有问必答,虽偶尔会有,客观的粗粝真实远好过刻意的完美精致:对,这就是机器人未来,雁过无痕叶落 ...
三网话费优惠接口源码
话费充值接口文档接口版本:1.0 ―.引言文档概述本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参考,可以帮助商户开发人员快速完成接口开发与联调,实现与话费 ...
三网手机实名制认证API，实名认证接口文档
1. 适用范围实名认证已经成为当下互联网环境下必不可少的一个环节,比如用户在进行信息发布.评论.社交等行为时,都需要先进行实名认证.它能够帮助互联网平台对入驻用户进行真实性核验,有利于建立完善的互联 ...
taobao.trades.sold.get-查询卖家已卖出的交易数据（根据创建时间),淘宝店铺卖出订单查询API接口，R2接口，oAuth2.0交易接口代码分享
一.taobao.trades.sold.get-查询卖家已卖出的交易数据(根据创建时间),淘宝店铺卖出订单查询API接口,R2接口,oAuth2.0交易接口代码分享搜索当前会话用户作为卖家已卖出的 ...
taobao.trades.sold.get-查询卖家已卖出的交易数据（根据创建时间),淘宝店铺卖出订单查询API接口，淘宝R2接口，淘宝oAuth2.0交易接口代码分享
一.taobao.trades.sold.get-查询卖家已卖出的交易数据(根据创建时间),淘宝店铺卖出订单查询API接口,R2接口,oAuth2.0交易接口代码分享搜索当前会话用户作为卖家已卖出的 ...
如何选择三网手机实名制认证API接口？
三网手机实名制认证,是指姓名.身份证.手机号验证是否一致. 目前,电信.联通.移动作为三家数据源,并没有进行数据整合,他们直接服务的客户,也大多数千万级别的银行.互联网巨头等等.那么,普通企业怎么拿到 ...
通达信交易接口API获取数据源码分享
在通达信交易接口下单之前,如何去了解快速获取交易数据呢?要是即使下单了,也不知道如何去查询,然后不管不问,等到需要你去止损了,你才回想起来去操作,这是很容易吃亏的做法的.在股票量化交易过程中,我们不仅 ...
分享淘宝时间服务器同步时间接口api和苏宁时间服务器接口api
本文章向大家介绍分享淘宝时间服务器同步时间接口api和苏宁时间服务器接口api,主要包括分享淘宝时间服务器同步时间接口api和苏宁时间服务器接口api使用实例.应用技巧.基本知识点总结和需要注意事项, ...

三网话费充值优惠接口API分享