话费充值api接口,对接流程
话费充值接口文档
接口版本:1.0
―、引言
- 文档概述
本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成接口开发与联调,实现与话费充值系统的交易互联\
- 阅读对象
本文阅读对象:开发人员与微客云系统对接支付相关的技术人员。
- 业务流程
- 点击添加店铺,只勾选CMS即可,或者店铺ID保存。
- 联系客服申请 app_key与app_secret 。
- 开发对接,需求在控制台进行预存。
二、对接接口
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) |
失败返回数据格式:
{"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退款成功) |
收到回调后,商户必须同步返回字符串 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、系统参数:
以下参数必须传参,全部采用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接口对接流程
(任务列表接口) 使用场景 通过徽芯~juhujiekou获取接口文档在线任务 建议定时调用此接口, 将获取的任务数据筛选后, 保存到你的本地数据库保存 请求对接 HTTP方法 Post 请求参数 参 ...
- 话费充值api接口--专业、稳定的技术对接
在专门的Api接口充值话费,更适用于对于话费充值有长期稳定需求的企业或者商家. 我们一般所了解的都是批量充值,批量充值的话操作简单,只要将号码和金额复制到表格中然后上传平台就可以自动充值,一次性可提供 ...
- 话费充值API接口源码文档
以前没有接触过话费充值api接口的小伙伴可以了解一下哦!我也可以直接给大家提供一个我自己开发的接口,技术是没得说的,一个字稳,比较我也参与过硅谷百亿项目.其次,我的接口真正实实在在能够看折扣的,优惠也 ...
- 与第三方Api接口对接需要注意的点
与第三方Api接口对接需要注意的点 目录 一.非技术对接 二.技术对接 三.必要措施 四.常见错误解决 一.非技术对接 [重要]画出流程时序图 查看对方文档,积极沟通 本公司接口文档和图发对方确认,一 ...
- api接口对接如何实现,php如何对接api
这篇文章来分享下api接口对接如何实现,还有源码,希望对新手有所帮助. 什么是API? 我的回答:API( 应用程序编程接口):一般来说,这是一套明确定义的各种软件组件之间的通信方法. 什么是API? ...
- 话费充值API接口的公司有哪些
市场上做话费接口充值的公司很多,而且这些公司基本都能提供一个这样对接的接口.可以在网上搜索提供API接口的公司进行比较一下,接口内容都是大同小异,区别就是能提供的话费充值货源是否可靠. 在公司经营稳定 ...
- 【PBL项目实战】户外智慧农场项目实战系列——5.天气预报API接口对接
[PBL项目实战]户外智慧农场项目实战系列--5.天气预报API接口对接 原文链接 https://mp.weixin.qq.com/s/jditkIEd-UK6cSQyCC_-Eg 本系列以户外智 ...
- 支付宝 app接口对接流程上
最近开发一个app,需要对接支付宝,现在来整理一下流程吧 1.登录蚂蚁金服开放平台,创建一个移动应用 创建应用中所需要的参数apicloud中会有 2.添加功能,配置公钥(应用公钥) 应用创建成功后, ...
- 如何用C# 实现免费快递查询API接口对接
接口对接常见的问题基本上是数据签名错误导致的接口联调失败,而API接口是获取网络服务最便捷的方式,合理地使用API接口开发项目可以大大提高开发效率,把精力都集中在程序的业务逻辑之上,避免重复造轮子. ...
- 常用物流快递单号查询API接口对接net源码示例_快递鸟
零售电商平台及ISV商家对物流api接口的需求有很多,今天我们主要分享的就是快递鸟快递单号查询接口的对接指南,快递单号查询接口对接的应用场景有很多,很多场景会遇到,最主要的就是电商网站用户打开&quo ...
最新文章
- Linux实战教学笔记32:企业级Memcached服务应用实践
- ICRA2021| 自动驾驶相关论文汇总
- grub resourceunknown filesystem异常处理
- Rera1N环境Linux,降级工具ReRa1n发布,降级真的来了?
- jQuery仿淘宝商城天猫鼠标移动过去,透明度降低
- 白话经典算法系列之六 快速排序 快速搞定
- echarts 生成 迁徙图_百度地图+echarts(迁徙图)
- DIY 3.5毫米/MMCX接口的耳机线(无麦)
- 最新WIN10系统封装教程2019系列(一)——定制母盘
- FoxitReader3.0注册码和foxit pdf creator key foxit pdf editor v2.0 key
- python头像右上角加红色数字_「微信头像右上角数字」微信头像右上角红色数字怎么添加? - seo实验室...
- python gbk 相互转换 utf8
- PreaparedStatement中execut的使用
- itextpdf 给pdf文档添加图片
- RAW格式转存PNG图片
- 成都工业学院(成都无机校/电子机械高等专科学校)百年校庆之行记
- python爬房源信息_Python:爬取airbnb房源信息(Selenium)
- html表格方式实现商品详情
- 【002】SPARC V8 体系结构第一章介绍
- GitHub热门项目 | PyTorch 资源大全,7400多星
热门文章
- 主流平面设计软件推荐,实用工具推荐必坑指南!
- 凑个热闹之美团 YOLOv6 ORT/MNN/TNN/NCNN C++推理部署
- 图标绘制入门1:简单介绍及图标设计规范
- offline强化学习之Revive SDK的使用
- 中国土地市场网landchina.com数据采集心得
- java目前开发的背景_Java web 开发构想[一] 背景和形势
- linux下mv命令参数详解,linux下的mv命令使用详解
- 纯净版windows8安装包下载
- mysql非安装_mysql非安装版的装配
- Sqlserver 生僻字