最近正在做一個小項目,其中一個要實現手機話費充值功能。我在網上搜羅了很久,最終找了聚合數據上的那個手機話費充值API,下面就分享一下,希望對需求的朋友有所幫助。
聚合數據是一個API聚合平臺,提供了超多各類API,它的手機話費充值接口也是不錯的。
1.手機話費充值API
1.1檢測手機號碼是否能充值
接口地址:http://op.juhe.cn/ofpay/mobile/telcheck
支持格式:json
請求方式:http post/get
請求示例:http://op.juhe.cn/ofpay/mobile/telcheck?cardnum=100&phoneno=13429667914&key=您申請的KEY
接口備註:檢測手機號碼及金額是否能充值
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
phoneno | string | 是 | 手機號碼 |
cardnum | string | 是 | 充值金額,目前可選:10、20、30、50、100、300 |
key | string | 是 | 應用APPKEY(應用詳細頁查詢) |
返回參數說明:
名稱 | 類型 | 說明 |
error_code | int | 返回碼 |
reason | string | 返回說明 |
result | string | 返回結果集 |
JSON返回示例:
{ "reason": "允許充值的手機號碼及金額", "result": null, "error_code": 0 }
1.2根據手機號和麪值查詢商
接口地址:http://op.juhe.cn/ofpay/mobile/telquery
支持格式:json
請求方式:http get/post
請求示例:http://op.juhe.cn/ofpay/mobile/telquery?cardnum=30&phoneno=18913515635&key=您申請的KEY
接口備註:根據手機號和麪值查詢商品信息
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
phoneno | string | 是 | 手機號碼 |
cardnum | string | 是 | 充值金額,目前可選:10、20、30、50、100、300 |
key | string | 是 | 應用APPKEY(應用詳細頁查詢) |
返回參數說明:
名稱 | 類型 | 說明 |
error_code | int | 返回碼 |
reason | string | 返回說明 |
result | string | 返回結果集 |
JSON返回示例:
{ "reason": "成功", "result": { "cardid": "191404", /*卡類ID*/ "cardname": "江蘇電信話費100元直充", /*卡類名稱*/ "inprice": 98.4, /*購買價格*/ "game_area": "江蘇蘇州電信" /*手機號碼歸屬地*/ }, "error_code": 0 }
1.3手機直充接口
接口地址:http://op.juhe.cn/ofpay/mobile/onlineorder
支持格式:json
請求方式:http get/post
請求示例:http://op.juhe.cn/ofpay/mobile/onlineorder?key=KEY&phoneno=18913513535&cardnum=100&orderid=2014111111113&sign=fb1ed32a9540c24b03cc0c06aabbb642
接口備註:依據用戶提供的請求爲指定手機直接充值,***如果充值過程中,遇到http網絡狀態異常或錯誤碼返回系統異常100014,請務必通過訂單查詢接口檢測訂單或聯繫客服,不要直接做失敗處理,避免照成不必要的損失!!!
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
phoneno | string | 是 | 手機號碼 |
cardnum | string | 是 | 充值金額,目前可選:10、20、30、50、100、300 |
orderid | string | 是 | 商家訂單號,8-32位字母數字組合,由您自己生成 |
key | string | 是 | 應用APPKEY(應用詳細頁查詢) |
sign | string | 是 | 校驗值,md5(OpenID+key+phoneno+cardnum+orderid),OpenID在個人中心查詢 |
返回參數說明:
名稱 | 類型 | 說明 |
error_code | int | 返回碼 |
reason | string | 返回說明 |
result | string | 返回結果集 |
JSON返回示例:
{ "reason": "訂單提交成功,等待充值", "result": { "cardid": "1900212", /*充值的卡類ID*/ "cardnum": "1", /*數量*/ "ordercash": 49.25, /*進貨價格*/ "cardname": "江蘇電信話費50元直充", /*充值名稱*/ "sporder_id": "20141120174602882", /*聚合訂單號*/ "uorderid":"2014123115121",/*商戶自定的訂單號*/ "game_userid": "18913515122", /*充值的手機號碼*/ "game_state": "0" /*充值狀態:0充值中 1成功 9撤銷,剛提交都返回0*/ }, "error_code": 0 }
1.4訂單狀態查詢
接口地址:http://op.juhe.cn/ofpay/mobile/ordersta
支持格式:json
請求方式:http get/post
請求示例:http://op.juhe.cn/ofpay/mobile/ordersta?key=&orderid=a112244411a
接口備註:查詢訂單的最新狀態,請確認訂單成功提交後,再查詢哦~
請求參數說明:
名稱 | 類型 | 必填 | 說明 |
orderid | string | 是 | 商家訂單號,8-32位字母數字組合,請填寫已經成功提交的訂單號 |
key | string | 是 | 應用APPKEY(應用詳細頁查詢) |
返回參數說明:
名稱 | 類型 | 說明 |
error_code | int | 返回碼 |
reason | string | 返回說明 |
result | string | 返回結果集 |
JSON返回示例:
{ "reason": "查詢成功", "result": { "uordercash": "5.000", /*訂單扣除金額*/ "sporder_id": "20150511163237508",/*聚合訂單號*/ "game_state": "1" /*狀態 1:成功 9:失敗 0:充值中*/ }, "error_code": 0 }
1.5狀態回調配置
充值接口測試完畢,需聯繫在線客服進行回調配置。
演示:
最後,附《手機話費充值》資費說明:
卡種 | 面額 | 價格 |
10元話費直衝 | ¥10.00 | ¥9.80~¥10.2 |
20元話費直衝 | ¥20.00 | ¥19.60~¥20.1 |
30元話費直衝 | ¥30.00 | ¥29.54~¥30 |
50元話費直衝 | ¥50.00 | ¥49.25~¥50 |
100元話費直衝 | ¥100.00 | ¥99.4~¥100 |
300元話費直衝 | ¥300.00 | ¥295.5~¥296.4 |