PAYMENT401: 단말기 페어링 미완료

이것이 의미하는 바

결제 단말기가 WCPOS와의 페어링을 완료하지 못했습니다.

단말기 설정을 확인한 후 페어링을 다시 시도하고, 결제 제공업체에 문의할 때는 추적 ID를 함께 알려 주세요.

조치 방법

이 기능이 작동하려면 먼저 설정을 변경해야 합니다. 위의 변경을 적용한 후에 재시도하세요. 변경하지 않고 재시도하면 같은 방식으로 실패합니다.

내 데이터

주문이나 상품 데이터에는 영향이 없습니다. 이 문제가 계속되면 결제 제공업체에 문의하세요.

문제 해결

1. 단말기 설정에서 페어링을 다시 시작하세요. 이때 단말기를 켜 둔 상태로 유지하고 계산대와 같은 네트워크에 연결해 두세요.
2. 기본 사항을 먼저 확인하세요. 단말기가 충전되어 있는지, 올바른 네트워크나 Bluetooth에 연결되어 있는지, 다른 계산대와 아직 페어링된 상태는 아닌지 확인합니다.
3. 로그 항목에는 추적 ID가 포함되어 있습니다. 페어링이 계속 완료되지 않는다면 결제 제공업체에 문의할 때 이 ID를 함께 알려 주세요.

확인할 위치

WCPOS가 이 오류를 저장할 수 있는 경우, 오류는 이를 발생시킨 기기에 기록됩니다. 스토어 상태 → 로그(내비게이션 서랍 하단의 심박 아이콘)를 열고 이 코드가 표시된 항목을 찾아 펼치세요. 펼쳐진 행에는 알기 쉽게 설명된 원인과 오류가 발생한 시점에 수집된 컨텍스트가 표시됩니다. 스토어 요청의 경우 이 컨텍스트에 서버 자체의 오류 코드(serverCode), HTTP status 또는 endpoint가 포함될 수 있으며, 표시되는 필드는 오류가 발생한 위치에 따라 다릅니다. 문제를 신고할 때는 스크린샷 대신 로그 화면 상단의 디버그 정보 복사(휴대폰과 태블릿에서는 디버그 정보 공유)를 사용하세요. 여기에는 앱 버전, 연결 상태, 가장 최근의 오류가 함께 담깁니다. 로그는 최대 30일간만 보관되므로 문제가 발생한 직후에 수집하세요. 또한 POS가 자체 로그 항목을 기록하기 전에 나타난 브라우저 콘솔 오류가 있다면 함께 복사하세요.

앱 내 로그 외에도 이 오류는 다음 위치에 흔적을 남길 수 있습니다:

• 결제 제공업체 대시보드: 단말기 제공업체의 자체 기록(예: Stripe Dashboard → Payments 또는 Square Dashboard)이 결제가 실제로 처리되었는지에 대한 최종 근거입니다. 결제를 재시도하기 전에 반드시 확인하세요.

세부 정보

• 코드: PAYMENT401 (TERMINAL_PAIRING_INCOMPLETE)
• 심각도: error
• 도입 버전: WCPOS 1.10.0