フィリピンの決済システムにおける一般的なエラー報告とトラブルシューティング

一般的なエラーコードとその意味

E100 - トランザクションタイムアウト
- 理由：インターネット接続が不安定、または銀行/決済ゲートウェイからの応答が遅い。
- 解決策：ネットワーク接続を確認し、後で再試行する。加盟店サーバーとペイメントゲートウェイ間の通信が正常であることを確認する。
E201 - 残高不足
- 理由：取引を完了するための資金が不足しています。
- 解決策: トップアップまたは支払い方法の変更をユーザーに促す。
E202 - シングル・リミット超過
- 理由: 取引額が銀行/電子財布が設定した1回の取引限度額を超えたため。
- 解決策：少額の支払いを複数回行うか、カード発行会社に連絡して限度額を増額するよう利用者に勧める。
E301/OMP_0010_01 (GCash専用）
- 「資金不足または限度額超過のため、取引に失敗しました。
- GCash ウォレットの残高が不足している、または 1 日の限度額 (通常 ₱ 50,000) に達している。
BPIエラーコード： BPI-9999
- 「一般的なエラー」、具体的な情報についてはBPIカスタマーサービスにお問い合わせください。
PayMayaエラー: PMY-4001
認証の失敗、通常は無効または期限切れのAPIキー

店頭窓口での現金支払いに関するよくある質問（ドラゴンペイ、セブンイレブンCLiQQなど）

無効/期限切れ参照番号
各OTC取引には24時間の有効期間があり、それを過ぎると注文を再生成しなければならない。
支払いは完了したが、ステータスが更新されない
通常、処理に15分～2時間かかる。4時間以上経っても更新されない場合は、支払機関に連絡し、証拠として領収書の写真を提出すること。

3.金額の不一致
顧客から支払われた金額が小数点以下2桁（PHP）まで正確であることを確認する。

PCI DSSコンプライアンス関連エラー（オンラインクレジットカード処理用）

1.3DS認証に失敗(Mastercard SecureCode/VBV Verification)
カード会員がOTPを誤って入力したため、複数回ロックされることがある。

2.AVSアドレスチェックサムの不一致(特にフィリピンでの国際カードの使用に影響する）
AVSチェックサムを無効にするか、システムに「AVSを無視する」オプションを追加することをお勧めします。

API統合クラスのトラブルシューティングステップ。

1️⃣ テスト環境:

curl --location --request POST 'https://api.sandbox.paymentprovider.ph/v3/payments'  \

--header 'Authorisation: Bearer YOUR_API_KEY' ￤「認証：ベアラ YOUR_API_KEY

--header 'Content-Type: application/json'  \

--data-raw '{'

 「金額": "1000"、

 「通貨」：「PHP」、

 ...

}'

2️⃣ 本番環境チェックリスト:

SSL 証明書が有効で、PCI に準拠していること（TLS ≥1.2）
サーバーIPがIPホワイトリストに追加されました。
✅ Webhookエンドポイントは一般にアクセス可能で、200ステータスコードを返す。
✅ PHP環境allow_url_fopen=On(該当する場合）

Bangko Sentral ng Pilipinas (BSP) Regulatory Requirements Notes.

⚠️ すべての失敗した金融取引の完全なログは、少なくとも5年間保存されなければならない。
⚠️ 同じユーザーについて認証失敗が繰り返されると、AMLC AML レビューのトリガーとなる可能性がある。
⚠️ メンテナンス期間による障害：BSPは毎週日曜日の午前03:00～05:00に強制決済ウィンドウを設けることを義務付けている。

さらなる支援が必要な場合は、それを提供することが推奨される：
完全なエラーコード + サブコード
発生タイムスタンプ(タイムゾーンGMT+8を含む)
クロスカレンシー決済の有無

フィリピンにおける決済システムの詳細なトラブルシューティングのためのガイドライン（続き）

銀行振込型取引特有のエラー

InstaPay/PESONetエラー分類
- IP-102 (インスタペイ）
  「受益者口座が見つかりません
  解決策
  - 受取人の口座番号と銀行コードの組み合わせを確認する
  - 銀行によっては、顧客が通常10桁の口座番号を使用している場合でも、12桁の口座番号を入力する必要がある（例：BPI）。
- PN-209 (PESONet)
  "カットオフ時間を超える取引"
  清算期限は銀行によって異なる：
```
タイムライン

    タイトル PESONetの当日到着締切時間の例

    2023-01-01 : BDO: 14:30 

    2023-01-01 : メトロバンク: 15:00

    2023-01-01 : ランドバンク: 16:00
```
繰り返し取引の検出
フィリピンの金融システムでは、同じ金額の取引が連続した場合、風当たり規制が発動される：
- InstaPay: ₱1万件以上の同一受取人からの取引を5分で自動的に審査保留
- PESONet: 同一バッチ内で±₋0.50の差があれば、再検査を回避できる。

GCash/電子財布の高度なトラブルシューティング

企業アカウント特有のエラー
```
エラーコード： G-XMP_3004_62  

意味："毎月のコーポレートウォレットの上限に達しました"
```
法人向けGCash口座の月間限度額はデフォルトで50万円で、引き出しには事前申請が必要です。
- SEC登録証明書
- BIR2303 税務登録

バイオメトリック認証に失敗
そのときauth_biomedical_factory時間だ：

# GCash公式推奨リトライロジック（疑似コード）



    if error == AUTH_BIOMETRIC_FAILURE.

        wait(minutes=5) 

        if retry_count <2.

            trigger_SMS_OTP_fallback()

        そうでなければ

            lock_account_for(24時間)



    vivo/Y シリーズ携帯電話のユーザーに適当光条件に特別な注意を払う必要がある    

    ```

QR Phスタンダード決済問題

ダイナミックQRコードの失敗
フィリピン中央銀行は、QR Phダイナミックコードが有効であるために、以下の要素を含むことを義務付けています：

フィールド	例	OBRが必要
CRC	sha256("merchant_id+txid")	✓
有効期限	ISO 8601フォーマット（マニラ時間帯）	✓

消費者側でスキャンに失敗する一般的な理由

# POSターミナル設定チェックリスト：



+ ピクセル密度≧300dpiのQRを生成する。  

+ [ ] JPEGの代わりにPNG形式  

! [BSPによって認証されたPSPマーチャントID（テストMIDではない）

Bangko Sentral Regulatory Sandboxに関する考察

革新的な決済ソリューションをテストする場合

1️⃣ 環境固有パラメータのシミュレーション::

ヘッダは必ず含まれていなければならない。

X-BSP-サンドボックス: true  

X-Test-Case-ID: {事前に承認されたテストケース番号}。

2️⃣ ストレステストの限界::
⚠️ 金曜日午後4時以降の一括テスト実行を禁止（週次請求との兼ね合い）

複雑な症例のリアルタイム診断が必要な場合は、このプロセスを報告することが推奨される：

A [元のリクエストを収集] --> B {機密データが含まれているか？｝    

B --> |Yes| C [OpenSSLで暗号化されている］     

B --> |No| D [ダイレクトアタッチログ］     

C & D --> E [ZIPに圧縮され、パスワードで保護されている］      

E --> F [BSP SecureUpload経由で送信]。

継続的な監視のための推奨ツールの組み合わせ：SplunkのFTS Monitor + BSP（無料版は、毎秒5トランザクションのリアルタイム分析をサポート）。

フィリピン決済システムのエキスパートレベルのトラブルシューティングマニュアル（続き）

クロスボーダー決済の特殊シナリオ処理

SWIFT特有のエラー

BSP-REMIT-004仲介銀行手数料の控除
不敬受取人が実際に受け取った金額が送金額を下回った場合。15-50
処方::

# 最適送金経路を計算するアルゴリズム・ロジック

def calculate_optimal_route(sender_bank, receiver_bank).

    if sender_bank in ['BPI', 'BDO'] and receiver_bank in ['Chinabank', 'RCBC']:: if sender_bank in ['BPI', 'BDO'] and receiver_bank in ['Chinabank', 'RCBC'].

        SWIFTの代わりに国内トランジットネットワークを使用する。

    そうでなければ

        return f "{max(15, amount*0.01)} USDの手数料が差し引かれることを明示的に知らせる"

暗号通貨取引所のチャンネル規制
BSPサーキュラーNo.1108に従う：
- 50万㌆以上の取引について、追加のKYC手続きが必要
- コモンエラーcrypto_kyc_tier2_requiredトリガーの状態

取引行動	リスク管理閾値
1日の買い越し額	≥200,000
同一販売者による連続取引	≥3回/時

POS端末ハードウェアのトラブルシューティング

インジェニコ/ランドバンク機器固有コードリスト

# Linuxシステムでログを読む例（root権限が必要です。）

sudo cat /var/log/payment-terminal/$(date +%Y-%m-%d).log | grep "E_"

一般的なハードウェアエラー対策：

LEDステータスコード	隠された意味	緊急プログラム
🔴🟡 交互に点滅（2回）	SIMカードが検出されない	プラグの抜き差し＋電話 *#06# ICCIDの確認
フラッシュモブの続き	EMVチップの読み取り失敗	[綿棒でチップをクリーニングする】→【磁気ストライプをスワイプしようとする】→【カード番号を手入力する

サーマルプリンタ通信プロトコルの競合
BluetoothとUSBを同時に接続すると表示されるPRINTER_BUSYエラー：

シーケンス図

    ターミナル->>プリンター：レシートAを印刷するUSBコマンド

    モバイルアプリ->>プリンター：Bluetoothコマンドで販促コンテンツを印刷 B

    プリンタ-->>ターミナル: BUSY_ERROR (0x7F)

    正しい処理はATコマンドでインターフェイスをロックすること。

    AT+CLAIM=USB

BSPリアルタイム・グロスセトルメント・システム（RTGS）運用・保守窓口

強制メンテナンス期間中のモニタリング強化勧告
配備は毎週日曜日の03:00-05:00 GMT+8を推奨：

#！/bin/bash

# RTGSメンテナンス期間ハートビート検出スクリプトサンプル



while maintenance_window_active; do

  

curl -X POST "https://bsp-monitor.ph/api/v1/ping" \

-H "Authorisation:Bearer $(cat /etc/bsp/api.key)"(認証:ベアラ $(cat /etc/bsp/api.key)) 

--data-raw '{"component": "RTGS", "region": "MANILA"}'.



if [ $?=0 ]; なら    

escalate_to_oncall_engineer --priority=P0   

フィー  



スリープ300  

done >> /var/log/rtgs_monitor.log

災害復旧プロトコルのトリガー条件

以下のイベントが発生すると、BCPプロファイルが自動的に有効になります：
InstaPay ✅ 連続 30 分間の失敗率 >15%
PESONet バッチファイル処理の遅延 ≥ 90 分
QR Phマスター証明書の有効期限が切れている（2年ごとに更新）。

AIによるインテリジェントなトラブルシューティングツールの推奨

フィリピンの現地で開発された専用の診断プログラム：

1.GCashアインシュタイン(ビジネス・マーチャントのみ）特徴は以下の通り：
-予測限度額管理（過去の取引パターンに基づく）
-音声IVRによる作業指示書の自動生成（タガログ語と英語の混在をサポート）

// APIレスポンスの例（AI分析結果）

{

"error_code"："G-XMP_3004_62"。

"提案されたアクション": {

"即時": ["代替クリアリング・チャンネルに切り替える"]、

"long_term": ["限度額引き上げのための業務検証資料の提出"]] 。

},

信頼度スコア:92%

}

複雑なケースのさらなるデバッグについては、BSPテクニカルサポートグループに以下のいずれかの方法で問い合わせることができる：

緊急ホットライン： (02) 8708-7087 (年中無休)
✉️ 暗号化されたメールボックス：[email protected] (PGPキーID: BSP2023-SOC)

フィリピンの決済システムにおける一般的なエラー報告とトラブルシューティング