话费充值API接口,三网可充,支持快充慢充

 更新时间:2021-09-29 20:08:31   作者:佚名   我要评论(0)

微客云地址: http://www.wikeyun.cn/ ―、引言1.1 文档概述本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快

微客云地址: http://www.wikeyun.cn/ 

―、引言

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、充值下单请求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、系统参数

以下参数必须传参全部采用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接口,三网可充,支持快充慢充

    微客云地址: http://www.wikeyun.cn/ ―、引言1.1 文档概述本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快
    2021-09-29
  • 微客云全新V2版本,个人中心也支持DIY自定义装修,上线滴滴打车CPS

    微客云全新V2版本,个人中心也支持DIY自定义装修,上线滴滴打车CPS

    1、微客云v2版本个人中心装修正式上线!!2、新增京东首页模块3、新增拼多多首页模块4、新增滴滴打车CPS5、新增独家个人支付宝批量划款功能,个人号也能给用户发工资!6、新
    2021-09-29
  • Go实现Redis连接池方法

    Go实现Redis连接池方法

    目录一、什么是连接池,连接池有什么用 二、代码展示 一、什么是连接池,连接池有什么用 先看看别人是怎么介绍连接池的吧: 连接池基本的
    2021-09-22
  • Go中使用加密算法的方法

    Go中使用加密算法的方法

    目录哈希算法加密模式对称加密⾮对称加密椭圆曲线加密算法ECC数字签名字符编码/解码巨人的肩膀哈希算法 md5 128bit,16字节 如:md5
    2021-09-22
  • Golang 定时器的终止与重置实现

    Golang 定时器的终止与重置实现

    昨日有读者对定时器的终止有疑问,今天我们来聊一聊定时器的终止与重置吧! 定时器是一种通过设置一项任务,在未来的某个时刻执行该任务的
    2021-09-22
  • golang time常用方法详解

    golang time常用方法详解

    说明         在golang中,时间转换都会通过Time类型做一系列转换。主要包含,时间戳和时间字符串,时间字符串转换成另
    2021-09-22
  • 在Colaboratory上运行Go程序的详细过程

    在Colaboratory上运行Go程序的详细过程

    前言 有一次,在逛 youtube 时,看到有个播主直接在文档上运行代码片段。 这把我一下子整蒙了,这是什么神操作? 一番搜索之后,知道了这是
    2021-09-22
  • 关于golang利用channel和goroutine完成统计素数的思路

    关于golang利用channel和goroutine完成统计素数的思路

    1. 需求 要求统计1-200000的数字中,哪些是素数?这个问题在本章开篇就提出来了,可以使用goroutine和channel来完成 2.分析思路 传统的方法,
    2021-09-22
  • Go中的条件语句Switch示例详解

    Go中的条件语句Switch示例详解

    Switch简介 Go的switch的基本功能和C、Java类似: switch 语句用于基于不同条件执行不同动作,每一个 case 分支都是唯一的,从上至下逐
    2021-09-22
  • 手把手教你导入Go语言第三方库

    手把手教你导入Go语言第三方库

    目录环境环境变量实践导包最好的学习方式就是实践。 我们通过导入gin包来深入学习。 环境 go 1.13.5 goland 2019.3.1 manjaro-
    2021-09-22

最新评论