Отчеты об общих ошибках и устранение неполадок в филиппинских платежных системах

Распространенные коды ошибок и их значение

1. E100 - Тайм-аут транзакции

   • Причина: нестабильное интернет-соединение или медленный ответ от банка/платежного шлюза
   • Решение: Проверьте сетевое соединение и повторите попытку позже; убедитесь, что связь между торговым сервером и платежным шлюзом нормальная.

2. E201 - Недостаточный баланс

   • Причина: Недостаточно средств на счете пользователя для завершения операции
   • Решение: предложите пользователю пополнить счет или изменить способ оплаты

3. E202 - Превышение одного лимита

   • Причина: Сумма транзакции превышает лимит одной транзакции, установленный банком/электронным кошельком
   • Решение: Посоветуйте пользователям совершать несколько небольших платежей или обратитесь к эмитенту карты, чтобы увеличить лимит.

4. E301/OMP_0010_01 (специфический для GCash)

   • "Транзакция не прошла из-за недостатка средств или превышения лимита"
   • Баланс кошелька GCash недостаточен или достиг дневного лимита (обычно ₱50,000)

5. Код ошибки BPI: BPI-9999

   • "Общая ошибка", обратитесь в службу поддержки клиентов BPI для получения конкретной информации.

6. Ошибка PayMaya: PMY-4001
   Сбой аутентификации, обычно недействительный или просроченный ключ API

Часто задаваемые вопросы о внебиржевых наличных платежах (например, Dragonpay, 7-Eleven CLiQQ и т.д.)

1. Недействительный/истекший номер ссылки
   Каждая внебиржевая сделка имеет 24-часовой срок действия, по истечении которого ордер должен быть сгенерирован заново.

2. Оплата произведена, но статус не обновлен
   Как правило, обработка занимает от 15 минут до 2 часов; в случае отсутствия обновлений в течение более 4 часов свяжитесь с поставщиком платежей и предоставьте фотографию квитанции в качестве доказательства

3.Несоответствие сумм
Убедитесь, что сумма, уплаченная клиентом, точна до двух знаков после запятой (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' \

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

--data-raw '{

 "сумма": "1000",

 "валюта": "PHP",

 ...

}'

2️⃣ Контрольный список производственной среды:

• ✅ SSL-сертификаты действительны и соответствуют требованиям PCI (TLS ≥1.2)
• ✅ IP-адрес вашего сервера был добавлен в белый список IP-адресов
• ✅ Конечная точка Webhook находится в открытом доступе и возвращает код состояния 200
• ✅ Среда PHPallow_url_fopen=On(если применимо)

Bangko Sentral ng Pilipinas (BSP) Regulatory Requirements Notes.

⚠️ Полный журнал всех неудачных финансовых операций должен храниться не менее 5 лет.
⚠️ Повторяющиеся сбои аутентификации одного и того же пользователя могут стать причиной проверки AMLC AML
⚠️ Сбой в связи с периодом технического обслуживания: BSP предписывает обязательное расчетное окно в 03:00-05:00 утра каждого воскресенья.

Если требуется дополнительная помощь, рекомендуется ее предоставить:
🔹 Полный код ошибки + подкод
🔹 Временная метка происшествия (включает часовой пояс GMT+8)
🔹 Участвуют ли кросс-валютные расчеты

Руководство по углубленному анализу платежных систем на Филиппинах (продолжение)

Ошибки, характерные для операций типа банковского перевода

1. Классификация ошибок InstaPay/PESONet

   • IP-102 (InstaPay)
     "Счет бенефициара не найден"
     Решение:

     • Проверьте номер счета получателя + комбинацию банковских кодов
     • Обратите внимание, что некоторые банки требуют вводить 12-значный номер счета (например, BPI), даже если клиент обычно использует 10-значный номер.

   • PN-209 (PESONet)
     "Транзакция превысила время отсечки"
     Сроки клиринга зависят от банка:

     хронология
     
         Заголовок Пример времени отключения PESONet для прибытия в тот же день
     
         2023-01-01 : бдо: 14:30 
     
         2023-01-01 : Метробанк: 15:00
     
         2023-01-01 : Ландбанк: 16:00
     
     

2. Обнаружение повторных транзакций
   В филиппинской финансовой системе при последовательных операциях на одну и ту же сумму срабатывает контроль "ветра":

   • InstaPay: ₱10 000+ транзакций от одного и того же получателя за 5 минут автоматически в ожидании проверки
   • PESONet: разница в ±₱0,50 в одной партии может обойти повторное тестирование

Поиск и устранение неисправностей в GCash/e-wallet

1. Ошибки, характерные для корпоративных счетов

   Код ошибки: G-XMP_3004_62  
   
   Значение: "Месячный лимит корпоративного кошелька достигнут".
   
   

   Месячный лимит по умолчанию для корпоративного счета GCash составляет ₱500,000, для снятия средств необходимо подать предварительную заявку.

   • Свидетельство о регистрации SEC
   • BIR2303 Налоговая регистрация

2. Биометрическая верификация не удалась
   Когдаauth_biomedical_factoryВремя:

   Официальная логика повторных попыток # GCash (псевдокод)
   
   
   
       if error == AUTH_BIOMETRIC_FAILURE.
   
           wait(minutes=5) 
   
           если retry_count <2.
   
               trigger_SMS_OTP_fallback()
   
           еще.
   
               lock_account_for(24h)
   
   
   
       Применимо к vivo/Y серии мобильных телефонов пользователи должны обратить особое внимание на условия освещения    
   
       ```
   
   
   
   

Вопросы оплаты по стандарту QR Ph

1. Сбой динамического QR-кода
   Центральный банк Филиппин требует, чтобы динамические коды QR Ph содержали следующие элементы для того, чтобы быть действительными:

2. Распространенные причины сбоев при сканировании на стороне потребителя

Контрольный список конфигурации POS-терминала #:



+ [ ] QR генерирует плотность пикселей ≥ 300 dpi  

+ [ ] Формат PNG вместо JPEG  

! [ ] PSP Merchant ID, сертифицированный BSP (не тестовый MID)  

Ноты для песочницы Бангко Сентарал

При тестировании инновационных платежных решений:

1️⃣ Моделирование специфических для окружающей среды параметров::

Заголовки должны содержать.

X-BSP-Sandbox: true  

X-Test-Case-ID: {номер предварительно утвержденного тестового случая}

2️⃣ Ограничения стресс-теста::
⚠️ запрещает проводить массовые тесты после 16:00 в пятницу (противоречит еженедельной тарификации).

Если требуется диагностика сложных случаев в режиме реального времени, рекомендуется сообщать об этом процессе:

A [собрать исходный запрос] --> B {содержит ли он конфиденциальные данные?}    

B --> |Yes| C [зашифровано с помощью OpenSSL]     

B --> |No| D [Журнал прямого вложения]     

C & D --> E [сжато в ZIP и защищено паролем]      

E --> F [передано через BSP SecureUpload]

Для текущего мониторинга предлагается комбинация инструментов: FTS Monitor от Splunk + BSP (бесплатная версия поддерживает анализ 5 транзакций в секунду в режиме реального времени).

Руководство по устранению неисправностей экспертного уровня для филиппинских платежных систем (продолжение)

Обработка специальных сценариев трансграничных платежей

1. Ошибки, характерные для SWIFT

   • BSP-REMIT-004: Вычет банковских комиссий посредников
     безнаказанность: Сумма, фактически полученная получателем, меньше суммы, отправленной15-50
     Рецепт::

     # Алгоритмическая логика для вычисления оптимальных путей денежных переводов
     
     def calculate_optimal_route(sender_bank, receiver_bank).
     
         если банк-отправитель в ['BPI', 'BDO'] и банк-получатель в ['Chinabank', 'RCBC']:: если банк-отправитель в ['BPI', 'BDO'] и банк-получатель в ['Chinabank', 'RCBC'].
     
             return 'Использовать внутристрановую транзитную сеть вместо SWIFT'
     
         еще.
     
             return f "Явно сообщите пользователю, что с него будет удержана комиссия за обработку {max(15, amount*0.01)} USD"
     
     

2. Ограничения каналов криптовалютных бирж
   В соответствии с Циркуляром BSP № 1108:

   • Дополнительные шаги KYC должны быть выполнены для операций свыше ₱500,000
   • распространённая ошибкаCRYPTO_KYC_TIER2_REQUIREDСостояние триггера:

Поиск и устранение неисправностей оборудования POS-терминалов

1. Список специфических кодов оборудования Ingenico/Landbank

Пример чтения журналов в системе # Linux (требуются привилегии root)

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

Общие меры борьбы с аппаратными ошибками:

2. Конфликт протоколов связи термопринтера
   Появляется при одновременном подключении Bluetooth и USBPRINTER_BUSYОшибка:

   sequenceDiagram
   
       Терминал->>Принтер: команда USB для печати чека A
   
       Мобильное приложение->>Принтер: команда Bluetooth для печати рекламного контента B
   
       Принтер-->>терминал: BUSY_ERROR (0x7F)
   
       Правильный процесс должен заблокировать интерфейс с помощью команды AT:.
   
       AT+CLAIM=USB 
   
   

Окно операций и технического обслуживания системы валовых расчетов в режиме реального времени (RTGS) BSP

1. Рекомендации по усиленному мониторингу для периодов обязательного технического обслуживания
   Развертывание рекомендуется проводить каждое воскресенье в 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)"\ 

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



if [ $? ! =0 ]; then    

escalate_to_oncall_engineer --priority=P0   

fi  



сон300  

выполнено >> /var/log/rtgs_monitor.log  

2. Условия срабатывания протокола аварийного восстановления

Следующие события автоматически активируют профиль BCP:
✅ Коэффициент отказов InstaPay в течение 30 минут подряд >15%
✅ Задержка обработки пакетных файлов PESONet ≥ 90 минут
✅ Срок действия сертификата мастера QR Ph истек (обновляется каждые 2 года)

Интеллектуальные рекомендации по устранению неисправностей на основе искусственного интеллекта

Специальная диагностическая программа, разработанная на Филиппинах:

1.GCash Einstein(Только для бизнес-торговцев) Особенности включают:
-Предсказуемое управление лимитами (на основе исторических моделей транзакций)
-Голосовой IVR, автоматически генерирующий рабочие заказы (поддержка тагальского и английского языков)

// Пример ответа API (результаты анализа ИИ)

{

"error_code": "G-XMP_3004_62".

"suggested_action": {

"немедленно": ["Переключиться на альтернативный канал очистки"],

"long_term": ["Предоставление материалов по проверке бизнеса для увеличения лимита"].

},

confidence_score:92%

}

Для дальнейшей отладки сложных случаев можно связаться с группой технической поддержки BSP любым из следующих способов:

📞 Горячая линия: (02) 8708-7087 (круглосуточно)
✉️ зашифрованный почтовый ящик:[email protected] (Идентификатор ключа PGP: BSP2023-SOC)