WooCommerceとPhilippine Paymentsの統合ハンズオン・ステップ

5月、ゴールド、2025年
ディークペイ
フィリピンでの支払い

WooCommerceとPhilippine Paymentsの統合ハンズオン・ステップ：総合ガイド

WooCommerceマーチャントがフィリピンの現地決済手段を統合する必要がある理由

Eコマースが活況を呈する中、フィリピンの顧客にローカライズされた決済ソリューションを提供することは、コンバージョンを高めるための重要な戦略となっている。東南アジアで最も急成長しているデジタル経済圏のひとつであるフィリピンには、独自の支払い習慣や嗜好があります。データによると、フィリピンのオンライン買い物客の60%以上が、国際クレジットカードよりも現地の支払い方法を好んでいる。

WooCommerceを使用してオンラインショップを立ち上げているマーチャント様にとって、Gcash、PayMaya、Dragonpayなどのフィリピンの主要な電子財布や銀行送金オプションと統合することで、ショッピングカートの放棄率を大幅に減らすことができます。これらのローカル決済ソリューションは、使いやすく、処理手数料が安いだけでなく、国際クレジットカードを持っていない消費者がいるという問題も解決してくれます。

技術的な観点から見ると、WooCommerceの高いスケーラビリティは、複数の支払い方法にアクセスするための理想的なプラットフォームです。適切なプラグインとAPI統合により、加盟店は既存のサイトアーキテクチャを変更することなく、新しい決済チャネルをシームレスに追加することができます。

準備：マーチャントアカウントの開設とAPI認証情報の取得

フィリピンで決済手段をうまく統合するための第一歩は、適切な決済サービスプロバイダー（PSP）を選ぶことです。ビジネスの規模や対象とする顧客層に応じて、取引レート、決済サイクルタイム、対応国・地域、テクニカルサポートの質などを考慮する必要があります。

マーチャントアカウントの登録と確認は、プロセスの重要な部分です。GCash を例にとってみましょう：

GCash Business Solutions のウェブサイトにアクセスし、「今すぐ申し込む」をクリックしてください。
会社情報フォームへの記入（営業許可証のコピーを含む）
役員・株主の本人確認書類の提出
1～3営業日の審査期間待ち
マーチャントIDとAPIキーが記載されたウェルカムメールを受け取る

同様に、DragonpayやPayMayaなどの他のゲートウェイにアクセスする場合は、同様のKYCプロセスを完了する必要があります。ユーザーベースの大部分をカバーするために、2-3の主要プラットフォームで同時にアカウントを申請することをお勧めします。

重要な注意事項APIクレデンシャル（通常、マーチャントID、シークレットキー、場合によっては暗号化塩）は安全な場所に保管してください。この機密情報は安全な場所に保管し、コードに直接書き込んではいけません。

WooCommerceバックエンドの基本設定

WordPressの管理画面にログインし、コアパラメータの設定を開始する：

PHPの拡張機能を有効にするサーバーにcURLとOpenSSLモジュールがインストールされていることを確認する。
```
php -m | grep -E 'curl|openssl'
```
これら2つのモジュールが表示されない場合は、ホスティングプロバイダーに連絡してインストールする必要があります。
パーマリンク構造の更新(設定＞パーマネントリンク）：
コールバックURLの有効性に影響する "Article Name "または "Numeric "を選択してください。
通貨と地域の設定::
- WooCommerce > 設定 > 一般
- 通貨：フィリピン・ペソ (₱)
- 通貨ポジション：左（₱99）
- サウザンド・セパレーター：、
- 小数点以下の区切り文字: .
税金の配分(該当する場合）：
品目タイプに基づく12% VATルールの正しい設定

GCash Access 詳細チュートリアル - 最も人気のあるフィリピンの電子財布

A) GCash公式プラグインのインストール方法

1.WordPressダッシュボードの「プラグイン」＞「プラグインのインストール」に移動します。
2.GCash for WooCommerce（グローブ・フィンテック・イノベーションズ開発）を検索する。
3.今すぐインストールをクリックしてアクティブにする
4.WooCommerce>設定>支払いからGCashオプションを見つけます。

B) API手動統合ソリューション

この方法は、利用可能な公式プラグインがない場合に使用できる：

// functions.phpにカスタム決済ゲートウェイクラスを追加する。

add_filter('woocommerce_payment_gateways', 'add_gcash_gateway')；

関数 add_gcash_gateway($gateways){

    $gateways[] = 'WC_Gateway_GCASH'；

    $gatewaysを返す。

}



class WC_Gateway_GCASH extends WC_Payment_Gateway {.

    

    パブリック関数 __construct() {

        $this->id = 'gcash'；

        // ...他のパラメーターを初期化する

        

        // APIエンドポイントの設定（サンドボックス/本番環境）

        $this->init_form_fields()；

        $this->init_settings()；

        

        add_action('woocommerce_update_options_payment...')., [$this,'process_admin_options']).

    }

    

}

主要パラメータの説明

api_url: https://gpi.gcash.com/pay/v2/create (本番環境）
リダイレクト_url: https://yourdomain.com/gcash-callback/
マーチャントIDGmail登録メールボックスで受信した8桁の英数字の組み合わせ

C) ウェブフックのコールバック処理

トランザクションステータスの通知を受け取るためのカスタムエンドポイントを作成する。

// コールバック用のREST APIルートを登録する  

add_action('rest_api_init', function(){)

    register_rest_route('gcash/v1','/notify', [])

        methods' => WP_REST_Server::CREATABLE、

        'callback' => 'handle_gcash_notification'、

                ]);

});



関数 handle_gcash_notification(WP_REST_Request $request){。

       // 最初にHMAC-SHA256署名を検証する！

       if(!verify_signature($request)) wp_send_json_error(null,403)；

       

       // payment_statusパラメータに基づいて注文ステータスを更新する。  

}

テストツールの推奨

Postmanはコールバック要求をシミュレートする
ングロック、ローカル開発環境をパブリック・ネットワークに公開

スペースの都合上、完全なコード例や技術的な詳細をお見せすることはできませんが...。

[次の章では、フィリピン固有の支払い方法と高度な最適化のヒントをご紹介します。］

Dragonpayペイメントゲートウェイ統合ガイド-銀行振込とオフラインチャネルをカバー

1.マーチャントアカウントの登録

フィリピン特有のDragonpayサポートが含まれています：

インターネット・バンキング（20以上 BDO、BPIなど）
コンビニ現金払い（セブンイレブン、MLhuillier）
ATMカウンター預金

口座開設の流れ::

dragonpay.phにアクセスし、"Merchant Sign Up "をクリックしてください。
会社登録書類の提出（SEC/DTI）
決済口座の開設（フィリピンの現地銀行口座を推奨）
API許可は、申請が承認された後に取得される：
- マーチャントID（6桁）
- シークレット・キー（32文字のハッシュ）

2.WooCommerceプラグイン設定方法

公式認定の「Dragonpay Payment Gateway」プラグインのご利用をお勧めします：

// wp-config.phpに定数の定義を追加する(オプション)

define('DRAGONPAY_MODE', 'production'); // サンドボックス|プロダクション

define('DRAGONPAY_MERCHANTID', '123456')；

バックエンドがパスを設定する：
WooCommerce → 設定 → 決済 → DragonPay
必須フィールドの説明：

説明例：「BDO/BPIネットバンキングまたはセブン-イレブンでのお支払い」）。
トランザクション・タイプSALE」または「AUTH」（事前承認）のいずれかを選択します。

3. コールバック・バリデーションを処理するPHPコード・スニペット

// verify_dragonpay_response.php サンプルコード：

$merchant_id = $_POST['merchantid']；

$txn_id = $_POST['txnid']；

$signature = strtoupper(hash('sha256',$merchant_id.$txn_id.$secret_key))；



if($signature ！= $_POST['署名']){。

    header('HTTP/1.0 403 Forbidden').

    退場する；

}



// 署名の検証通過後、注文ステータスを更新する: // 署名が通過すると、注文ステータスが更新される。

$order = wc_get_order($_POST['procref'])；

switch($_POST['status']){。

    case 'S'. 

        $order->payment_complete()；

        ブレイク

    case 'F'.

        $order->update_status('failed')；

        ブレイク    

}

よくある質問トラブルシューティング：
|エラーコード｜原因分析｜解決法
|—|—|—|
|DP001|署名の不一致|秘密鍵にスペースが含まれていないか確認してください。
|DP033|通貨タイプエラー|WooCommerceがPHP(₱)に設定されていることを確認してください。
|DP040|||

PayMaya エンタープライズアクセスプロセス - クレジットカードおよびスキャナによるお支払い

A) SDKのインストールと環境の準備

PayMayaは2つの統合オプションを提供しています：

オプション1：チェックアウトAPI（埋め込みフォーム）

# WordPressのrootがcomposerを実行してSDKをインストールする。

composer require paymaya/paymaya-sdk:^2.0

サーバーが要件を満たしていることを確認する必要がある：

PHP ≥ 7.3
OpenSSLエクステンション有効

オプション2：WooCommerceの決済プラグイン

公式プラグインの機能比較表：

無料版	エンタープライズ・エディション
月会費	₱0	₱2999
取引手数料	3%+15₱。	1,5%+10₱。
対応カード Visa/MC AMEX/JCB

B) ウェブフック・セキュリティ設定のポイント

PayMayaはHTTPSとTLS≥1,2コールバックアドレスを必要とし、Let's Encrypt無料証明書は開発段階で利用可能です。

.htaccess強制ジャンプのルールを追加する。

RewriteEngineオン 

RewriteCond %{SERVER_PORT} ！443$

RewriteRule ^(.*)$ https://%{http_host}/$1 [r=301,l]

署名検証のコアロジック

関数 verify_paymaya_webhook(){

    $received_sign = $_SERVER['HTTP_X_PAYMAYA_SIGNATURE']；

    $payload = file_get_contents("php://input")；

    

    ダッシュボードから // YOUR_PUBLIC_KEY  

    openssl_verify(

        $payload。

        base64_decode($received_sign)、

        your_public_key。

        openssl_algo_sha256	

    );

}

店頭非電子決済ソリューションの統合

銀行口座を持たないユーザー・グループについては、次のように考える：

a) パラワン・エクスプレス・ペラ・パダラ

特徴：フィフィ全体で1,800以上の現金回収のためのオフライン店舗

統合のステップ：
1.Woocommerceのバックエンドは、"PeraPadala送金 "プラグインをインストールします。
2.設定ページパートナー番号を入力（PNRCコードは別途申請が必要）

カスタマー・オペレーション・フローチャート

[注文する] → [支払いにパラワンを選択する] → [8桁の参照番号を生成する] → [顧客はその番号を持ってどの店でも支払う] 。

注意点 ❗️ には、1回の取引につき15₱の固定手数料がかかるが、通常は買い手が負担する。

次のセクションでは、マルチゲートウェイのスイッチング戦略とパフォーマンス最適化のヒントについて掘り下げる。

より詳細なコード例やプラットフォーム別のテストケースが必要ですか？今後も専門的なコンテンツを追加していきますので、具体的なニーズの方向性をお知らせください。

マルチペイメントゲートウェイのインテリジェントなスイッチングとパフォーマンス最適化戦略

1.ダイナミックな支払い方法表示ロジック

ジオフェンシング・テクノロジー・アプリケーション：顧客のIPに基づき、ローカライズされた支払いオプションの自動マッチング
"`php
add_filter('woocommerce_available_payment_gateways', 'filter_gateways_by_country')；

関数 filter_gateways_by_country($available_gateways) { { ゲートウェイを国別にフィルタリングする。
if(isset(WC()->customer)) {。
$country = WC()->customer->get_billing_country()；

// フィリピンの顧客可視化チャネル
if('PH' === $country) {。
unset($available_gateways['paypal']); //PayPalを隠す
$available_gateways['gcash']->order_button_text = __('Pay in seconds via GCash', '.woocommerce')；
} else {
// 海外顧客向けのデフォルト・チャンネル
unset($available_gateways['dragonpay'])；
}
}
$available_gatewares を返す。
}
“`

デバイスタイプの検出（モバイル優先でコードスイープ決済を表示）：
"`php
// モバイル検出ロジックをfunctions.phpに追加する
ファンクション is_mobile_checkout() {
return wp_is_mobile() && is_checkout()；
}

// モバイル版GCashウォレットの特別テキストアラート
add_action('wp_head', function(){)
if(is_mobile_checkout()){」。
エコー ";；
}
});
“`

2.取引成功率向上プログラム

A) フェイルオーバー機構の実装コード例
プライマリゲートウェイがタイムアウトした場合、自動的に切り替わる：

"`php
を試す。
$response = $gcash_api->createPayment(...)；
} catch (API_Timeout_Exception $e) {.
// GCashインターフェイスのタイムアウト後、Dragonpayを試す。
log_error("GCashタイムアウト、Dragonpayにフォールバック")；
$_POST['payment_method'] = 'dragonpay'；
WC()->session->set('chosen_payment_method','dragonpay')；
wp_safe_redirect(wc_get_checkout_url())。
退場する；
}
“`

B) インテリジェント・ルーティング・アルゴリズムのパラメータ設定テーブル

|重み付け係数｜計算｜最適化目的
|—|—|—|
ヒストリカル・サクセス・レート｜（サクセスしたトランザクション数／総リクエスト数）×100%｜コンバージョン率の最大化
決済スピード｜T+1～T+3営業日で変動｜資金回転効率｜T+1～T+3営業日で変動。
フィーコスト｜固定フィー＋パーセンテージドロー｜利益の最大化

PHPの実装例：
"`php
$gateway_score = []；

foreach ($active_geteways as $id => gateway){.
スコア = 0.6*$gateway->success_rate +0.3*(1/$settlement_days)+0.1*(1-$fee_rate)；
}

arsort($gateway_score); // スコアの降順でソートする。
$recommended_id=key($gateway_score)；

// フロントエンドに「おすすめタブ」を追加する。
add_filter("woocommerce_{$recommended_id}_title",function(){...})；
“`

—

PCI DSS準拠の主なチェックポイント

国際的な決済セキュリティ基準への準拠を確実にするためには、集中的な検証が必要である：

a). SAQ-AEP 自己評価チェックリスト（第三者主催の支払ページ用）
- TLS暗号化必須（SSLv3は無効
- ウェブアプリケーションファイアウォール（WAF）のルールを最新バージョンに更新しました。
- SSRF 攻撃を防ぐために `allow_url_fopen` を無効にする PHP の設定

.user.in`の設定を推奨する。
“`
memory_limit=256M
max_execution_time=90
post_max_size=64M
upload_max_filesize=16M

disable_functions="exec,passthru,shell_exec,system"
“`

b). WooCommerce特有のセキュリティ対策

データベースレベル：保存されたカード番号トークンの定期的なクリーニング
SQLクエリの例：
"`sql
DELETE FROM wp_postmeta WHERE meta_key LIKE '_ebanx_hash%' AND DATEDIFF(NOW(),post_date)>180；
“`
ファイル監視スクリプトの例（悪意のあるインジェクションの検出）：

「バッシュ
#！/bin/bash

# コア文書の変更のためのスキャニング
diff -qr /var/www/html/wp-content/plugins/woocommerce \
/tmp/original_copy|grep -iv "translations" > /var/log/wc_security.log

#リアルタイムアラーム機構構成
inotifywait -m-r -format '%w%f' plugins/paymaya \
| while ファイルを読む; do
curl -X POST https://api.security.com/alerts \
-d "file=$file modified on $(日付)"
完了
“`

—

Googleアナリティクス Eコマーストラッキング強化導入ガイド

各支払いチャネルのパフォーマンスを正確にモニターするには、以下のコードを展開する必要がある：

GA4測定プロトコルの埋設ポイント例

チェックアウトページはデータレイヤーを追加する：
「ジャバスクリプト

““

GTAG.js追跡イベントコード：

"`javascript gtag("event", "select_promotion", {)
items:[{
item_name: "グラブペイ割引"、
creative_name：「Banner_POSA」、
promotion_id: "promo_june2024″}]、
payment_type:jQuery("#payment input[name='method']:checked").val()
});
“`
主要指標ウォッチドッグの提案
- コンバージョンファネル分析：「チェックアウト開始→支払い選択→取引完了」の各段階における解約率の比較。例えば、Dragonpayのユーザーは銀行のOTP認証セッションで15%バウンスの異常があることがわかります。
- ARPU比較：Gcashユーザーの平均注文額はOTCより37%高い（データ収集中）

—

より詳細なパフォーマンス・ベンチマーク・データやセキュリティ監査テンプレートが必要ですか？強化したい方向性をご指定いただければ、プロフェッショナル・グレードのソリューションを提供いたします。

WooCommerceとPhilippine Paymentsの統合ハンズオン・ステップ