토스페이스페이 오류는 대부분 앱·권한·네트워크·단말 설정만 점검해도 해결됩니다.
1) 30초 빠른 점검(공통)
- 앱/OS 최신화: 토스 앱·브라우저·POS앱 업데이트
- 네트워크: 와이파이 ↔ LTE/5G 전환, VPN 해제
- 시스템 시간: 단말 시간 자동 설정(SSL 오류 예방)
- 캐시/쿠키: 브라우저 캐시 삭제 후 재시도(크롬/엣지)
- 다른 결제수단으로 테스트(일시적 카드사/기관 장애 분리)
2) 페이스페이(얼굴결제) 오류 — 사용자 체크리스트
- 등록 확인: 토스 앱 > 전체 탭 > “페이스페이” 검색 후 등록 상태 확인/재등록
- 카메라 권한: 카메라 접근 허용, 전면 카메라 렌즈 이물질 제거
- 조도/각도: 밝은 곳에서 모자/마스크 제거, 얼굴 정면 유지
- 2차 인증: 요구 시 앱의 2차 비밀번호 또는 추가 인증 입력
- 멤버십 연동 오류 시: 멤버십 재연동 → 결제수단 재선택
- 매장 단말 메뉴: 직원에게 “페이스페이 결제” 메뉴 선택 요청
3) 증상별 원인·해결
증상 | 가능 원인 | 해결 |
---|---|---|
얼굴 인식 실패 | 카메라 권한/조도/각도 문제 | 권한 허용·재등록·밝은 환경에서 재시도 |
결제는 되지만 포인트 미적립 | 멤버십 미연동/오류 | 멤버십 재연동 → 결제수단 재선택 |
“기관 오류” 메시지 | 카드사/은행/국세청 등 원천기관 장애 | 다른 결제수단/시간대 재시도, 영수증 보관 |
브라우저 결제 실패 | 캐시/쿠키·리다이렉트 URL·광고차단 | 캐시 삭제, 확장프로그램 비활성, success/fail URL 확인 |
4) 가맹점/운영자(토스페이먼츠) — 자주 보는 오류코드
코드 | 의미 | 대응 |
---|---|---|
PROVIDER_STATUS_UNHEALTHY | 카드사·은행 등 원천기관 장애 | 대체 결제수단 노출, 재시도 안내 |
INCORRECT_SUCCESS/FAIL_URL_FORMAT | 콜백 URL 형식 오류 | 정규 URL 사용·프로토콜/도메인 일치 |
INVALID_AMOUNT_VALUE | 결제금액 유효성 오류 | 정수/소수점·통화 단위 재검증 |
NOT_SELECTED_PAYMENT_METHOD | 결제수단 미선택 | 위젯 이벤트 완료 후 승인 요청 |
5) 브라우저·단말 결제 오류(웹)
- 캐시/쿠키 삭제 후 재시도, 시크릿 창 테스트
- 확장 프로그램 일시 비활성(광고차단·추적차단 등)
- 모바일 인앱 브라우저 대신 기본 브라우저 열기
- 리다이렉트 차단·팝업 차단 해제
6) 고객센터/공식 문서
본 글은 정보 제공 목적이며, 실제 오류·장애 여부는 토스/토스페이먼츠 공식 공지·문서로 최종 확인하세요. 최종 업데이트: 2025-09-15.