話費充值接口文檔
接口版本：1.0
―、引言
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 | 整數 | 是 | 充值金額（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}}
版權聲明：本文內容由互聯網用戶自發貢獻，該文觀點僅代表作者本人。本站僅提供信息存儲空間服務，不擁有所有權，不承擔相關法律責任。如發現本站有涉嫌抄襲侵權/違法違規的內容， 請發送郵件至 舉報，一經查實，本站將立刻刪除。
