필리핀 결제 시스템의 일반적인 오류 보고 및 문제 해결
필리핀 결제 시스템의 일반적인 오류 보고 및 문제 해결
일반적인 오류 코드 및 의미
-
E100 - 트랜잭션 시간 초과
- 이유: 인터넷 연결이 불안정하거나 은행/결제 게이트웨이의 응답이 느립니다.
- 해결 방법: 네트워크 연결을 확인하고 나중에 다시 시도하여 판매자 서버와 전자결제 게이트웨이 간의 통신이 정상인지 확인합니다.
-
E201 - 잔액 부족
- 이유: 거래를 완료할 수 있는 사용자 계정의 자금이 부족합니다.
- 해결 방법: 사용자에게 결제 방법을 충전하거나 변경하라는 메시지를 표시합니다.
-
E202 - 단일 한도 초과
- 이유: 거래 금액이 은행/전자지갑에서 설정한 단일 거래 한도를 초과합니다.
- 해결 방법: 사용자에게 소액 결제를 여러 번 하거나 카드 발급사에 연락하여 한도를 늘리도록 조언하세요.
-
E301/OMP_0010_01 (GCash 전용)
- "자금 부족 또는 한도 초과로 인해 거래가 실패했습니다."
- GCash 지갑 잔액이 부족하거나 일일 한도(보통 ₱50,000)에 도달했습니다.
-
BPI 오류 코드: BPI-9999
- "일반 오류"인 경우, 구체적인 정보는 BPI 고객 서비스에 문의하세요.
-
PayMaya 오류: PMY-4001
인증 실패, 일반적으로 유효하지 않거나 만료된 API 키
OTC 카운터 현금 결제에 대해 자주 묻는 질문(예: Dragonpay, 7-Eleven CLiQQ 등)
-
유효하지 않거나 만료된 참조 번호
각 OTC 거래의 유효기간은 24시간이며, 그 이후에는 주문을 다시 생성해야 합니다. -
결제가 완료되었지만 상태가 업데이트되지 않았습니다.
일반적으로 처리하는 데 15분~2시간이 소요되며, 4시간이 지나도 업데이트되지 않으면 결제 서비스 제공업체에 연락하여 영수증 사진을 증거로 제출하세요.
3.금액 불일치
고객이 결제한 금액이 소수점 이하 두 자리까지 정확한지 확인하세요(PHP). 불일치하면 실패로 처리됩니다.
PCI DSS 규정 준수 관련 오류(온라인 신용 카드 처리의 경우)
1.3DS 인증 실패(마스터카드 보안 코드/VBV 인증)
카드 소지자가 OTP를 잘못 입력하여 여러 번 잠길 수 있습니다.
2.AVS 주소 체크섬 불일치(특히 필리핀에서 국제 카드 사용에 영향을 미침)
AVS 검사를 비활성화하거나 시스템에 'AVS 무시' 옵션을 추가하는 것이 좋습니다.
API 통합 클래스에 대한 문제 해결 단계.
1️⃣ 테스트 환경:
curl --location --request POST 'https://api.sandbox.paymentprovider.ph/v3/payments' \.
--헤더 '권한 부여: 무기명 YOUR_API_KEY' \.
--헤더 '콘텐츠 유형: 애플리케이션/json' \.
--data-raw '{
"금액": "1000",
"통화": "PHP",
...
}'
2️⃣ 프로덕션 환경 체크리스트:
- ✅ 유효하고 PCI를 준수하는 SSL 인증서(TLS ≥1.2)
- ✅ 서버 IP가 IP 화이트리스트에 추가되었습니다.
- ✅ 웹훅 엔드포인트는 공개적으로 액세스할 수 있으며 200 상태 코드를 반환합니다.
- ✅ PHP 환경
allow_url_fopen=온(해당되는 경우)
필리핀 필리핀은행(BSP) 규정 요구 사항 참고 사항.
⚠️ 모든 실패한 금융 거래의 전체 로그는 최소 5년 동안 보관해야 합니다.
⚠️ 동일한 사용자에 대한 인증 실패가 반복되면 AMLC AML 검토가 시작될 수 있습니다.
⚠️ 유지보수 기간으로 인한 장애: BSP는 매주 일요일 오전 03:00-05:00에 의무적으로 정산 기간을 지정하고 있습니다.
추가 지원이 필요한 경우 이를 제공하는 것이 좋습니다:
🔹 전체 오류 코드 + 하위 코드
🔹 발생 타임스탬프(시간대 GMT+8 포함)
🔹 교차 통화 결제 포함 여부
필리핀의 결제 시스템 심층 문제 해결을 위한 가이드라인(계속)
은행 송금 유형 거래와 관련된 오류
-
InstaPay/PESONet 오류 분류
-
IP-102 (InstaPay)
"수취인 계정을 찾을 수 없음"
솔루션:- 수취인 계좌 번호 + 은행 코드 조합 확인
- 일부 은행에서는 고객이 일반적으로 10자리 계좌번호를 사용하더라도 12자리 계좌번호를 입력해야 합니다(예: BPI).
-
PN-209 (PESONet)
"트랜잭션이 마감 시간을 초과했습니다."
청산 마감일은 은행마다 다릅니다:타임라인
제목 PESONet의 당일 도착 마감 시간 예시
2023-01-01 : B도 : 14:30
2023-01-01 : 메트로뱅크: 15:00
2023-01-01 : 랜드뱅크: 16:00
-
-
반복 거래 탐지
필리핀 금융 시스템은 동일한 금액의 연속 거래에 대해 횡재 통제를 발동합니다:- InstaPay: 동일한 수취인으로부터 5분 동안 10,000건 이상의 거래가 자동으로 검토 대기 중입니다.
- PESONet: 동일한 배치에서 ±₱0.50의 차이로 반복 테스트를 피할 수 있습니다.
GCash/전자지갑 고급 문제 해결
-
기업 계정과 관련된 오류
오류 코드: G-XMP_3004_62
의미: "월별 기업 지갑 한도에 도달했습니다."
기업 GCash 계정의 기본 월 한도는 ₱500,000이며, 출금하려면 사전 신청서를 제출해야 합니다.
- SEC 등록 증명서
- BIR2303 세금 등록
-
생체 인식 인증 실패
언제인증_바이오메디컬_공장시간:# GCash 관계자가 제안한 재시도 로직(의사 코드)
오류 == AUTH_BIOMETRIC_FAILURE.
wait(minutes=5)
retry_count <2.
trigger_SMS_OTP_fallback()
else.
lock_account_for(24h)
생체/Y 시리즈 휴대폰 사용자에게 적용되며 조명 조건에 특히 주의해야 합니다.
```
QR Ph 표준 결제 문제
- 동적 QR코드 오류
필리핀 중앙은행에서는 QR Ph 동적 코드가 유효하려면 다음 요소를 포함해야 한다고 규정하고 있습니다:
| 필드 | 예제 값 | OBR 필요 |
|---|---|---|
| CRC | SHA256("가맹점_ID+ TXID") | ✓ |
| 유효기간 | ISO 8601 형식(마닐라 표준 시간대) | ✓ |
- 소비자 측에서 스캔 실패가 발생하는 일반적인 이유
# POS 단말기 구성 체크리스트:
+ [ ] QR은 300dpi 이상의 픽셀 밀도를 생성합니다.
+ [ ] JPEG 대신 PNG 형식
! [ ] BSP에서 인증한 PSP 판매자 ID(테스트용 MID 아님)
방코 중앙 규제 샌드박스 고려 사항
혁신적인 결제 솔루션을 테스트할 때
1️⃣ 환경별 매개변수 시뮬레이션::
헤더에는 다음이 포함되어야 합니다.
X-BSP-Sandbox: true
X-Test-Case-ID: {사전 승인된 테스트 케이스 번호}
2️⃣ 스트레스 테스트 제한 사항::
⚠️ 금요일 오후 4시 이후에는 대량 테스트 실행이 금지됩니다(주간 청구와 충돌).
복잡한 사례에 대한 실시간 진단이 필요한 경우 이 프로세스를 보고하는 것이 좋습니다:
A [원본 요청 수집] --> B {민감한 데이터가 포함되어 있습니까?}
B --> |예| C [OpenSSL로 암호화됨]
B --> |아니요| D [로그 직접 첨부]
C & D --> E [ZIP으로 압축 및 비밀번호로 보호됨]
E --> F [BSP SecureUpload를 통해 전송됨]
지속적인 모니터링 권장 도구 조합: Splunk의 FTS 모니터 + BSP(무료 버전은 초당 5개의 트랜잭션 실시간 분석 지원).
필리핀 결제 시스템을 위한 전문가 수준의 문제 해결 매뉴얼(계속)
해외 결제 특별 시나리오 처리
-
SWIFT 관련 오류
- BSP-REMIT-004: 중개 은행 수수료 공제
면책수취인이 실제로 수령한 금액이 송금한 금액보다 적습니다.15- 50
처방전::최적의 송금 경로를 계산하기 위한 # 알고리즘 로직
def calculate_optimal_route(sender_bank, receiver_bank).
sender_bank가 ['BPI', 'BDO'], receiver_bank가 ['Chinabank', 'RCBC']:: sender_bank가 ['BPI', 'BDO'], receiver_bank가 ['Chinabank', 'RCBC']인 경우.
'SWIFT 대신 국가 내 전송 네트워크 사용'을 반환합니다.
else.
반환 f "사용자에게 {최대(15, 금액*0.01)} USD 수수료가 공제됨을 명시적으로 알립니다."
- BSP-REMIT-004: 중개 은행 수수료 공제
-
암호화폐 거래소 채널 제한
BSP 회람 번호 1108에 따릅니다:- 500,000파운드 이상의 거래에 대해 완료해야 하는 추가 KYC 단계
- 일반적인 오류
crypto_kyc_tier2_required트리거 조건:
| 거래 행동 | 위험 관리 임계값 |
|---|---|
| 하루 동안의 누적 구매 | ≥200,000 |
| 동일한 판매자의 연속 거래 | ≥시간당 3회 이상 |
POS 단말기 하드웨어 문제 해결
- 인제니코/랜드뱅크 장비별 코드 목록
# Linux 시스템에서 로그 읽기 예제(루트 권한 필요)
sudo cat /var/log/payment-terminal/$(date +%Y-%m-%d).log | grep "E_"
일반적인 하드웨어 오류 대책:
| LED 상태 코드 | 숨겨진 의미 | 긴급 프로그램 |
|---|---|---|
| 🔴🟡 번갈아 깜박임(2회) | SIM 카드가 감지되지 않음 | 플러그를 뽑았다가 다시 꽂고 *#06#로 전화 *#06# ICCID 확인 |
| 계속되는 플래시몹 | EMV 칩 판독 실패 | [알코올 솜으로 칩 청소] → [마그네틱 띠 스와이프 시도] → [카드 번호 수동 입력] |
- 감열식 프린터 통신 프로토콜 충돌
Bluetooth와 USB를 동시에 연결할 때 나타납니다.PRINTER_BUSY오류:시퀀스 다이어그램
터미널->>프린터: 영수증을 인쇄하는 USB 명령어 A
모바일 앱->>프린터: 프로모션 콘텐츠를 인쇄하는 블루투스 명령 B
프린터-->>단말기: BUSY_ERROR (0x7F)
올바른 프로세스는 AT 명령어로 인터페이스를 잠급니다.
AT+CLAIM=USB
BSP 실시간 총 정산 시스템(RTGS) 운영 및 유지보수 기간
- 필수 유지 관리 기간에 대한 향상된 모니터링 권장 사항
매주 일요일 03:00-05:00 GMT+8 사이에 배포하는 것을 권장합니다:
#!/bin/bash
# RTGS 유지보수 기간 하트비트 감지 스크립트 샘플
동안 유지보수_창_활성; do
curl -X POST "https://bsp-monitor.ph/api/v1/ping" \
-H "Authorisation:Bearer $(cat /etc/bsp/api.key)" \.
--데이터-raw '{"component": "RTGS", "region": "MANILA"}'
if [ $?! =0 ]; then
escalate_to_oncall_engineer --priority=P0
fi
sleep300
done >> /var/log/rtgs_monitor.log
- 재해 복구 프로토콜 트리거 조건
다음 이벤트는 자동으로 BCP 프로필을 활성화합니다:
✅ 30분 연속 InstaPay 실패율 >15%
✅ PESONet 배치 파일 처리 지연 90분 이상
✅ QR Ph 마스터 인증서 만료(2년마다 갱신)
AI 기반 지능형 문제 해결 도구 권장 사항
필리핀 현지에서 개발된 전용 진단 프로그램입니다:
1.GCash 아인슈타인(비즈니스 판매자만 해당) 기능에는 다음이 포함됩니다:
-예측적 한도 관리(과거 거래 패턴 기반)
-음성 IVR 자동 생성 작업 지시서(타갈로그어와 영어 혼합 지원)
// API 응답 예시(AI 분석 결과)
{
"error_code": "G-XMP_3004_62".
"suggested_action": {
"즉시": ["대체 청산 채널로 전환"],
"long_term": ["한도 증액을 위한 사업 검증 자료 제출"]
},
confidence_score:92%
}
복잡한 사례에 대한 추가 디버깅이 필요한 경우 다음 방법으로 BSP 기술 지원 그룹에 문의할 수 있습니다:
📞긴급 핫라인: (02) 8708-7087(연중무휴 24시간 이용 가능)
✉️ 암호화된 사서함:[email protected] (PGP 키 ID: BSP2023-SOC)
Chinese (China) 
English 
Chinese (Taiwan) 
Japanese 
Korean 
Russian