電話リチャージを実装する
php メソッド: 1. 電話リチャージ インターフェイスを開きます; 2. カプセル化されたコード クラスを導入します; 3. インターフェイスの基本情報を設定します; 4. 電話リチャージ注文を送信します; 5. プッシュステータス情報を対応URLに送信; 6. 携帯電話と金種に基づいてチャージがサポートされているかどうかを確認; 7. 「if ($local_sign == $sign) {...}」を通じてビジネスロジック処理を実行します。
このチュートリアルの動作環境: Windows 7 システム、PHP バージョン 8.1、Dell G3 コンピューター。
php で電話料金をリチャージするにはどうすればよいですか?
PHP に基づく集約電話料金リチャージ インターフェイスの例
1. インターフェイス アプリケーションの起動
このコードは、電話料金リチャージに基づく電話料金リチャージ機能です集計データを基にしたAPIです。ご利用前に、
https://www.juhe.cn/docs/apiより通話料金インターフェースサービスの開通申請をしていただく必要があります。 /id/85?s=cpppcn
。
アグリゲーションと関連するサービス契約を締結した場合にのみ正式に使用できます。初期段階ではテスト環境の開設やドッキングテストの申請も可能です。
インターフェイスの詳細な説明については、アグリゲーションの公式ドキュメントを参照してください。
2. インターフェイスの使用法
2.1. カプセル化されたコード クラスの導入
include "JuheHuaFei.class.php";
2.2. 必要なパラメーターの設定
// 接口基本信息配置 $env = 1; // 接口环境类型,1:正式环境接口 2:测试环境接口 $appKey = 'b842820xxxxxxxxxxxxxxxxxx'; //从聚合申请的话费充值接口key $openId = 'JHb0d92d94ce6axxxxxxxxxxx'; //注册聚合账号就会分配的openid,在个人中心可以查看 // 初始化 $juheHuaFei = new JuheHuaFei($appKey, $openId, $env);
2.3.電話リチャージ注文の送信
// 提交话费充值订单 $orderId = '111111111'; //自己定义一个订单号,需要保证唯一 $mobile = '189xxxxxxxx'; // 需要充值的手机号码 $perValue = '1'; // 话费面值,可以选择的面额1、2、5、10、20、30、50、100、300 $submitOrderResult = $juheHuaFei->submitOrder($mobile, $perValue, $orderId); if ($submitOrderResult) { if ($submitOrderResult['error_code'] == '0') { // 订单提交成功,根据实际业务逻辑进行处理 echo "订单提交成功,订单号:" . $submitOrderResult['result']['sporder_id']; print_r($submitOrderResult); } else { // 提交返回码error_code非正常状态,依据官方文档错误码说明,进行逻辑处理 // 比如:10014,系统异常 / 208516,重复的订单号 等,需要进行二次查询/人工确认处理,不要直接失败处理,避免造成不必要的损失 print_r($submitOrderResult); } } else { // 可能网络异常等问题,未获得正确响应结果,建议进行二次查单/人工确认,不要直接失败处理,避免造成不必要的损失 // 依据自己的业务逻辑进行处理 echo "请求异常,请确认"; }
リクエスト結果:
Array ( [reason] => 订单提交成功,等待充值 [result] => Array ( [cardid] => 10423 [cardnum] => 1 [ordercash] => 1.06 [cardname] => 江苏电信话费1元 [sporder_id] => J201125162114667xxxxxxxx [uorderid] => 111111111 [game_userid] => 189xxxxxxxx [game_state] => 0 ) [error_code] => 0 )
2.4. 注文ステータスのクエリ
注文ステータスを積極的にクエリすることに加えて、ステータス コールバック通知をユーザーに提供することもできます。集約 URL では、注文ステータスが変化すると、集約はステータス情報を対応する URL にアクティブにプッシュします。
// 话费订单充值状态查询 $orderId = '111111111'; // 需要查询的订单号,即提交订单时传递的orderId $orderStatusResult = $juheHuaFei->queryOrderStatus($orderId); if ($orderStatusResult) { // 打印返回结果 print_r($orderStatusResult); // 根据实际业务逻辑进行处理 if ($orderStatusResult['error_code'] == '0') { //查询成功 if ($orderStatusResult['result']['game_state'] == '1') { // 订单充值成功了 echo "订单充值成功"; } elseif ($orderStatusResult['result']['game_state'] == '9') { // 订单充值失败 echo "订单充值失败"; } elseif ($orderStatusResult['result']['game_state'] == '0') { // 订单充值中 echo "订单充值中"; } elseif ($orderStatusResult['result']['game_state'] == '-1') { //订单受理失败,可能是如运营商维护、账户余额不足等情况 echo "订单受理失败"; } } else { //查询状态失败,可能订单号不存在等情况 echo "查询失败:" . $orderStatusResult['reason'] . "(" . $orderStatusResult['error_code'] . ")"; } } else { // 可能网络异常等问题,未获得正确响应结果,建议进行二次查询 // 依据自己的业务逻辑进行处理 echo "请求异常,请确认"; }
返される結果:
Array ( [reason] => 查询成功 [result] => Array ( [uordercash] => 1.060 [sporder_id] => J2011251629516xxxxxxxxxx [game_state] => 9 ) [error_code] => 0 )
2.5. 携帯電話と金種に基づいてチャージがサポートされているかどうかを確認します
主に番号セグメントに基づいてチャージがサポートされているかどうかを判断します。実際の業務では使用しない機能かもしれません 小さなインターフェース。
// 根据手机号码及面额查询是否支持充值 $mobile = '1342966xxxx'; // 手机号码 $perValue = '10'; // 话费面值 $telCheckResult = $juheHuaFei->telCheck($mobile, $perValue); if ($telCheckResult) { if($telCheckResult['error_code'] == '0'){ //说明支持充值,可以继续充值操作,以下可以根据实际需求修改 echo "OK"; }else{ //暂不支持充值,以下可以根据实际需求修改 echo "对不起,该面额暂不支持充值"; } } else { // 可能网络异常等问题,未获得正确响应结果,建议进行二次查询 // 依据自己的业务逻辑进行处理 echo "请求异常,请确认"; }
2.6. 携帯電話と宗派に基づいた商品情報の取得
この小さなインターフェースは、実際のビジネスで使用する必要はありません。
// 根据手机号码和面额获取商品信息 $mobile = '1342966xxxx'; // 手机号码 $perValue = '10'; // 话费面值 $telQueryResult = $juheHuaFei->telQuery($mobile, $perValue); if ($telQueryResult) { if($telQueryResult['error_code'] == '0'){ // 查询成功,可以根据实际逻辑修改 print_r($telQueryResult); }else{ // 查询失败,可以根据实际逻辑修改 print_r($telQueryResult); } } else { // 可能网络异常等问题,未获得正确响应结果,建议进行二次查询 // 依据自己的业务逻辑进行处理 echo "请求异常,请确认"; }
戻り結果:
Array ( [reason] => 查询成功 [result] => Array ( [cardid] => 10880 [cardname] => 浙江移动话费10元 [inprice] => 10.2 [game_area] => 浙江杭州移动 ) [error_code] => 0 )
2.7. 注文ステータス通知
プッシュ URL アドレス: 構成のために集約に提供します (セキュリティを強化するために、集約をプッシュすることもできます)サーバー IP はホワイトリストに登録されています)
プッシュ メソッド: POST
プッシュ パラメーター:
PHP が非同期通知 (コールバック) を受信する参照コード:
/** * 接受话费\加油卡\流量充值业务 异步通知参数 参考示例 */ $appkey = "b842820xxxxxxxxxxxxxxxxxx"; //您申请的数据的APIKey $sporder_id = addslashes($_POST['sporder_id']); //聚合订单号 $orderid = addslashes($_POST['orderid']); //商户的单号 $sta = addslashes($_POST['sta']); //充值状态 $sign = addslashes($_POST['sign']); //校验值 $local_sign = md5($appkey.$sporder_id.$orderid); //本地sign校验值 if ($local_sign == $sign) { if ($sta == '1') { //充值成功,根据自身业务逻辑进行后续处理 } elseif ($sta =='9') { //充值失败,根据自身业务逻辑进行后续处理 } }
2.8、JuheHuaFei.class.php
JuheHuaFei.class.php 完全なコード
<?php //---------------------------------- // 聚合数据-手机话费充值API调用类--示例代码 // 官方接口文档:https://www.juhe.cn/docs/api/id/85 //---------------------------------- class JuheHuaFei { private $appkey; private $openid; // 提交订单接口URL private $submitUrl; // 订单状态查询接口URL private $orderStatusUrl; // 检测手机号码是否能充值URL private $telCheckUrl; // 根据手机号和面值查询商品URL private $telQueryUrl; /** * JuheHuaFei constructor. * @param [string] $appkey [接口密钥] * @param [string] $openid [账号openid] * @param [int] [$env 接口环境类型 1:正式环境 2:测试环境] */ public function __construct($appkey, $openid, $env = 1) { $this->appkey = $appkey; // 申请到的话费接口请求key $this->openid = $openid; // OpenID在聚合个人中心查询 if ($env == 1) { // 正式环境,接口地址 $this->submitUrl = 'http://op.juhe.cn/ofpay/mobile/onlineorder'; // 提交订单接口URL $this->orderStatusUrl = 'http://op.juhe.cn/ofpay/mobile/ordersta'; // 订单状态查询接口URL $this->telCheckUrl = 'http://op.juhe.cn/ofpay/mobile/telcheck'; // 检测手机号码是否能充值URL $this->telQueryUrl = 'http://op.juhe.cn/ofpay/mobile/telquery'; // 根据手机号和面值查询商品URL } else { // 测试环境,接口地址 $this->submitUrl = 'http://test-v.juhe.cn/ofpay/mobile/onlineorder'; // 提交订单接口URL $this->orderStatusUrl = 'http://test-v.juhe.cn/ofpay/mobile/ordersta'; // 订单状态查询接口URL $this->telCheckUrl = 'http://test-v.juhe.cn/ofpay/mobile/telcheck'; // 检测手机号码是否能充值URL $this->telQueryUrl = 'http://test-v.juhe.cn/ofpay/mobile/telquery'; // 根据手机号和面值查询商品URL } } /** * 提交话费充值订单 * @param [string] $mobile [手机号码] * @param [int] $pervalue [充值面额] * @param [string] $orderid [自定义单号] * @return [array] */ public function submitOrder($mobile, $pervalue, $orderid) { $sign = md5($this->openid . $this->appkey . $mobile . $pervalue . $orderid);// 校验值计算 $params = array( 'key' => $this->appkey, 'phoneno' => $mobile, 'cardnum' => $pervalue, 'orderid' => $orderid, 'sign' => $sign ); $content = $this->juheHttpRequest($this->submitUrl, $params, 1); return $this->_returnArray($content); } /** * 查询订单的充值状态 * @param [string] $orderid [自定义单号] * @return [array] */ public function queryOrderStatus($orderid) { $params = 'key=' . $this->appkey . '&orderid=' . $orderid; $content = $this->juheHttpRequest($this->orderStatusUrl, $params); return $this->_returnArray($content); } /** * 根据手机号码及面额查询是否支持充值 * @param string $mobile [手机号码] * @param int $pervalue [充值金额] * @return boolean */ public function telCheck($mobile, $pervalue) { $params = 'key=' . $this->appkey . '&phoneno=' . $mobile . '&cardnum=' . $pervalue; $content = $this->juheHttpRequest($this->telCheckUrl, $params); return $this->_returnArray($content); } /** * 根据手机号码和面额获取商品信息 * @param string $mobile [手机号码] * @param int $pervalue [充值金额] * @return array */ public function telQuery($mobile, $pervalue) { $params = 'key=' . $this->appkey . '&phoneno=' . $mobile . '&cardnum=' . $pervalue; $content = $this->juheHttpRequest($this->telQueryUrl, $params); return $this->_returnArray($content); } /** * 将JSON内容转为数据,并返回 * @param string $content [内容] * @return array */ public function _returnArray($content) { return json_decode($content, true); } /** * 请求接口返回内容 * @param string $url [请求的URL地址] * @param string $params [请求的参数] * @param int $ipost [是否采用POST形式] * @return string */ public function juheHttpRequest($url, $params = false, $ispost = 0) { $httpInfo = array(); $ch = curl_init(); curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1); curl_setopt($ch, CURLOPT_USERAGENT, 'JuheData'); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); curl_setopt($ch, CURLOPT_TIMEOUT, 30); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); if ($ispost) { curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $params); curl_setopt($ch, CURLOPT_URL, $url); } else { if ($params) { curl_setopt($ch, CURLOPT_URL, $url . '?' . $params); } else { curl_setopt($ch, CURLOPT_URL, $url); } } $response = curl_exec($ch); if ($response === FALSE) { //echo "cURL Error: " . curl_error($ch); return false; } $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); $httpInfo = array_merge($httpInfo, curl_getinfo($ch)); curl_close($ch); return $response; } }
推奨学習: "PHP ビデオ チュートリアル "
以上がPHPで電話料金をリチャージする方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。