매장 연결

데스크톱 및 모바일 전용

이 화면은 데스크톱 및 모바일 앱에서만 표시됩니다. 웹 사용자는 yourdomain.com/pos 에서 POS에 직접 접속하고 WordPress 자격 증명으로 로그인합니다.

연결 화면 개요

WCPOS 데스크톱 또는 모바일 앱을 열면 연결 화면이 표시됩니다. 여기에서 매장 연결과 사용자 로그인을 관리합니다.

새 매장 추가

1. 텍스트 필드에 WooCommerce 매장 URL을 입력합니다(예: https://mystore.com).
2. 연결을 클릭합니다
3. WordPress 자격 증명으로 로그인하도록 리디렉션됩니다
4. 로그인에 성공하면 앱으로 돌아갑니다

여러 매장

필요한 만큼 WooCommerce 매장을 연결할 수 있습니다. 각 매장은 연결 화면에 별도의 카드로 표시되며, 다음 정보를 보여줍니다:

• 매장 이름 및 파비콘
• 매장 URL
• 해당 매장의 로그인한 사용자

여러 위치나 사업체를 관리하는 경우 유용합니다.

매장별 여러 사용자

각 매장에는 여러 사용자가 동시에 로그인할 수 있습니다. 다음과 같은 경우에 유용합니다:

• 교대 근무 전환 - 이전 계산원이 로그아웃하기 전에 새 계산원이 로그인할 수 있습니다
• 여러 대의 계산대 구성 - 서로 다른 기기에서 서로 다른 계산원이 사용
• 빠른 전환 - 사용자 계정 간에 쉽게 전환

사용자 추가

다른 사용자를 해당 매장에 추가하려면 "로그인한 사용자" 옆의 버튼을 클릭합니다.

사용자 전환

사용자 배지(예: "Brenda")를 클릭하면 해당 사용자로 POS를 엽니다.

사용자 제거

사용자 배지의 **×**를 클릭하면 해당 사용자가 매장에서 로그아웃됩니다.

매장 제거

매장 카드의 빨간색 × 버튼을 클릭하면 목록에서 제거됩니다. 이 작업은 모든 사용자를 로그아웃시키고 앱에서 매장 연결을 제거합니다.

데모 매장

화면 하단에 "데모 매장 입장" 링크가 표시될 수 있습니다. 이 링크를 사용하면 자체 매장 데이터에 영향을 주지 않고 WCPOS 기능을 사용해 볼 수 있도록 데모 WooCommerce 매장에 연결됩니다.

문제 해결

먼저 확인할 항목: X-Frame-Options

데스크톱 및 모바일 앱은 로그인, 결제, 영수증에 iframes를 사용합니다. X-Frame-Options: DENY 또는 SAMEORIGIN 을 보내는 서버 헤더나 플러그인이 하나라도 있으면 로그인이 작동하지 않습니다. 이는 앱 로그인 실패의 가장 흔한 원인입니다. 다른 항목을 확인하기 전에 로그인 페이지의 응답 헤더를 확인하세요(브라우저 개발자 도구 또는 curl -I https://yourstore.com/wp-login.php).

내 매장에 연결할 수 없나요?

• WordPress 사이트에 WCPOS 플러그인이 설치되고 활성화되어 있는지 확인하세요.
• 올바른 URL을 사용하고 있는지 확인하세요(https:// 포함 — WooCommerce REST API에는 SSL이 필요함).
• 먼저 웹 브라우저에서 yourdomain.com/pos 를 열어 플러그인이 작동하는지 확인하세요.
• WooCommerce REST API에 접근할 수 있는지 확인하세요.
• 사용자 계정에 POS 접근 권한이 있는지 확인하세요.

데스크톱 또는 모바일 앱에서 로그인이 실패합니다.

대부분의 앱 로그인 실패는 보안 또는 캐싱 플러그인이 로그인 iframe을 차단해서 발생합니다.

• X-Frame-Options headers(보안 플러그인 또는 서버에서 설정됨)가 로그인 iframe을 차단합니다. 위 참고 사항을 확인하세요. 보안 플러그인을 일시적으로 비활성화하고 로그인한 다음 다시 활성화하세요(세션은 약 일주일 동안 유지됩니다).
• 보안 플러그인 — Wordfence, Really Simple Security, WPS Hide Login, iThemes/Solid Security, Defender Pro가 흔한 원인입니다. 전체 목록과 해결 방법은 플러그인 충돌에서 확인하세요.
• Wordfence 2FA — 2FA 코드 필드가 로그인 iframe에 표시되지 않습니다. 현재는 POS 사용자에 대해 2FA를 비활성화하세요.
• 사용자 지정 로그인 URL(예: WPS Hide Login) — 앱이 로그인 페이지를 찾을 수 없습니다. 표준 /wp-admin/ URL을 사용하세요.
• 캐싱 플러그인은 문제가 되는 플러그인을 비활성화한 뒤에도 차단된 로그인 양식을 계속 제공할 수 있습니다. 캐시를 지우거나 앱 캐시를 지우고 데스크톱 앱을 다시 설치하세요.

연결 화면에 "REST API requires authentication" 또는 보안 플러그인 오류가 표시됨

플러그인(예: Force Login 또는 JWT 인증 플러그인)이 모든 REST API 요청에 인증을 요구하고 있어, 앱이 사이트의 공개 정보를 읽을 수 없습니다. 이제 앱은 사이트 유형을 잘못 보고하는 대신 서버의 실제 메시지(예: "인증된 사용자만 REST API에 접근할 수 있습니다")를 표시합니다.

해결 방법: 보안 플러그인이 /wp-json/wcpos/ 및 /wp-json/wc/v3/ 에 대한 비인증 접근을 허용하도록 구성하거나, 첫 연결을 완료하는 동안만 비활성화하세요.

"WordPress 사이트로 보이지 않음"(데스크톱 앱)

데스크톱 앱은 HTTP Link 헤더를 통해 REST API를 찾습니다. 플러그인(일반적으로 Image Prioritizer 또는 기타 성능 플러그인)이 해당 헤더를 과도하게 채우거나 잘라내면 검색에 실패합니다. 해결 방법: 이미지 최적화 / 헤더 수정 성능 플러그인을 비활성화한 뒤 다시 시도하세요.

앱에 업데이트가 필요하다고 표시되거나 업데이트 후 충돌함

앱과 서버 플러그인의 버전이 맞지 않는지 확인하세요. WCPOS 플러그인은 아직 업데이트가 필요한데 앱 스토어에서 앱 업데이트가 배포되었을 수 있습니다(또는 그 반대일 수 있습니다). 앱과 WCPOS 플러그인이 같은 주요 버전인지 확인하세요. WCPOS v1.9.0+ 앱에는 v1.8.0 이상의 WCPOS 플러그인이 필요합니다.

"빠른 매장 데이터베이스를 만들 수 없음" 오류

첫 로그인 시 발생하는 경쟁 상태입니다. 앱을 완전히 닫은 후 다시 시도하세요. 보통 두 번째 시도에서 성공합니다.

사용자 선택 화면에서 멈춤(데스크톱 앱)

로그인 후 사용자 이름은 보이지만 다음 단계로 진행하는 방법이 명확하지 않을 수 있습니다. POS로 들어가려면 사용자 이름/이름을 클릭하세요. 이름 자체가 버튼입니다.

연결이 계속 실패하나요?

• 먼저 웹 브라우저에서 yourdomain.com/pos 에 접속해 플러그인이 작동하는지 확인하세요
• 사이트의 오류 로그에서 문제가 있는지 확인하세요
• 호스트가 REST API를 차단하고 있지 않은지 확인하세요. 호스팅별 참고 사항을 참조하세요
• 서버가 최소 요구 사항을 충족하는지 확인하세요