話費(fèi)充值接口文檔
接口版本：1.0
―、引言
1.1文檔概述
本文檔提供話費(fèi)充值接口規(guī)范說(shuō)明，提供一整套的完整的接入示例(http 接口)供商戶參 考，可以幫助商戶開(kāi)發(fā)人員快速完成接口開(kāi)發(fā)與聯(lián)調(diào)，實(shí)現(xiàn)與話費(fèi)充值系統(tǒng)的交易互聯(lián)。
公司官網(wǎng)：http://www.wikeyun.cn/
1.2閱讀對(duì)象
本文閱讀對(duì)象：開(kāi)發(fā)人員與微客云系統(tǒng)對(duì)接支付相關(guān)的技術(shù)人員。
1.3業(yè)務(wù)流程
1、打開(kāi)控制臺(tái) https://control.wikeyun.cn/ 進(jìn)行注冊(cè)賬號(hào)
2、點(diǎn)擊添加店鋪，只勾選CMS即可，或者店鋪ID保存。
3、聯(lián)系客服申請(qǐng) app_key與app_secret 。
4、開(kāi)發(fā)對(duì)接，需求在控制臺(tái)進(jìn)行預(yù)存。
二、話費(fèi)充值接口
1、充值請(qǐng)求下單（post 表單提交）
網(wǎng)關(guān)URL：https://router.wikeyun.cn/rest/Recharge/pushOrder
|
參數(shù)名 | 類型 | 必填 | 參數(shù)說(shuō)明 |
store_id | 字符串 | 是 | 店鋪ID |
mobile | 字符串 | 是 | 充值號(hào)碼 |
order_no | 字符串 | 是 | 充值訂單號(hào) |
money | 整數(shù) | 是 | 充值金額（50,100,200） |
recharge_type | 整型 | 是 | 1快充 0慢充 |
notify_url | 字符串 | 是 | 異步回調(diào)地址（POST） |
change | 整數(shù) | 否 | 失敗更換渠道充值 0 否 1是 不傳系統(tǒng)根據(jù)設(shè)置判斷 |
source | 整形 | 否 | 是否強(qiáng)制渠道 |
注意：因?yàn)槊總€(gè)渠道價(jià)格不同，不同用戶提交的業(yè)務(wù)不同，默認(rèn)不強(qiáng)制；
失敗返回?cái)?shù)據(jù)格式：
{"code":"1003","msg":"app_key不能為空","time":"1624868000","data":null}
成功返回?cái)?shù)據(jù)格式：
{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}
2、回調(diào)通知
|
參數(shù)名 | 類型 | 參數(shù)說(shuō)明 |
order_no | 字符串 | 充值訂單號(hào) |
order_number | 字符串 | 官方訂單號(hào) |
status | 字符串 | 交易結(jié)果（0 待支付 1 已付 充值中 2充值成功 3充值失敗 需要退款 4退款成功 6待充值 7 已匹配） |
收到回調(diào)后，商戶必須同步返回字符串 success，否則平臺(tái)認(rèn)為商戶沒(méi)有收到回調(diào)，會(huì)重復(fù)發(fā)送5
次回調(diào)。
3、查詢接口（post 表單提交）
網(wǎng)關(guān)URL：https://router.wikeyun.cn/rest/Recharge/query
|
參數(shù)名 | 類型 | 必填 | 參數(shù)說(shuō)明 |
order_number | 字符串 | 是 | 官方訂單號(hào) |
失敗返回?cái)?shù)據(jù)格式：
{"code":"1003","msg":"app_key不能為空","time":"1624868000","data":null}
成功返回?cái)?shù)據(jù)格式：
{"code":"0000","msg":"獲取成功","data":{"order_number":"xxxx","status":"1","mobile":"13786517891","amount":"100","order_no":"xxxx"}}
4、查詢余額接口（post 表單提交）
網(wǎng)關(guān)URL：https://router.wikeyun.cn/rest/User/query
數(shù)據(jù)格式：
{"code":"0000","msg":"獲取成功","data":{"money":"100","id":1234}}
版權(quán)聲明：本文內(nèi)容由互聯(lián)網(wǎng)用戶自發(fā)貢獻(xiàn)，該文觀點(diǎn)僅代表作者本人。本站僅提供信息存儲(chǔ)空間服務(wù)，不擁有所有權(quán)，不承擔(dān)相關(guān)法律責(zé)任。如發(fā)現(xiàn)本站有涉嫌抄襲侵權(quán)/違法違規(guī)的內(nèi)容， 請(qǐng)發(fā)送郵件至 舉報(bào)，一經(jīng)查實(shí)，本站將立刻刪除。