# 매장 연결

데스크톱 및 모바일 전용

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

## 연결 화면 개요[​](#connect-screen-overview "연결 화면 개요으로 직접 링크")

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

<!-- -->

## 새 매장 추가[​](#adding-a-new-store "새 매장 추가으로 직접 링크")

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

## 여러 매장[​](#multiple-stores "여러 매장으로 직접 링크")

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

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

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

## 매장별 여러 사용자[​](#multiple-users-per-store "매장별 여러 사용자으로 직접 링크")

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

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

### 사용자 추가[​](#adding-a-user "사용자 추가으로 직접 링크")

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

### 사용자 전환[​](#switching-users "사용자 전환으로 직접 링크")

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

### 사용자 제거[​](#removing-a-user "사용자 제거으로 직접 링크")

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

## 매장 제거[​](#removing-a-store "매장 제거으로 직접 링크")

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

## 데모 매장[​](#demo-store "데모 매장으로 직접 링크")

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

## 문제 해결[​](#troubleshooting "문제 해결으로 직접 링크")

먼저 확인할 항목: `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가 흔한 원인입니다. 전체 목록과 해결 방법은 [플러그인 충돌](/ko/support/troubleshooting/plugin-conflicts.md)에서 확인하세요.
* **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를 차단하고 있지 않은지 확인하세요. [호스팅별 참고 사항](/ko/support/performance/server.md)을 참조하세요
* 서버가 [최소 요구 사항](/ko/support/performance/server.md)을 충족하는지 확인하세요