最近正在做一個小項目,其中一個要實現手機話費充值功能。我在網上搜羅了很久,最終找了聚合數據上的那個手機話費充值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 |