# 이메일 알림

WCPOS는 사이트 전체 WooCommerce 이메일 설정과 별도로, POS 주문에 대해 어떤 WooCommerce 알림 이메일을 발송할지 이메일별로 제어할 수 있습니다. 판매를 처리한 **캐셔**에게도 알림을 보낼 수 있습니다.

설정은 **결제** 화면에 있습니다 — **WP Admin → POS → 설정 → 결제**로 이동하세요. 이메일 설정은 주문 상태 및 결제 게이트웨이 섹션 위에 있습니다.

POS 주문 이메일 안내

WooCommerce의 기본 이메일 트리거는 POS 주문에서 항상 정상적으로 작동하지 않습니다. POS는 WooCommerce가 인식하지 못하는 *POS - Open* 및 *POS - Partial* 같은 사용자 정의 상태를 사용하기 때문입니다. WCPOS는 주문이 이러한 상태에서 완료됨, 처리 중 또는 보류 중으로 전환될 때 새 주문 이메일을 수동으로 다시 트리거하므로, 주문이 결제 과정에서 어떤 경로를 거쳤든 안정적으로 알림을 받을 수 있습니다.

## 세 가지 이메일 그룹[​](#the-three-email-groups "세 가지 이메일 그룹으로 직접 링크")

각 그룹 상단에 **마스터 토글**이 있습니다. 토글이 켜져 있으면 아래에 체크박스 목록이 나타나 각 이메일 유형을 개별적으로 활성화하거나 비활성화할 수 있습니다. 토글이 꺼져 있으면 개별 이메일 체크박스 상태와 관계없이 해당 이메일은 POS 주문에 대해 발송되지 않습니다.

### 관리자 이메일[​](#admin-emails "관리자 이메일으로 직접 링크")

*"POS 주문에 대한 WooCommerce 관리자 알림 이메일"* — **기본적으로 켜져 있습니다.**

**WooCommerce → 설정 → 이메일 → (이메일 유형) → 수신자**에 구성된 주소로 발송됩니다.

| 이메일          | 기본값   | 발송 시점                                            |
| --------------- | -------- | ---------------------------------------------------- |
| **새 주문**     | ✓ 선택됨 | POS 주문이 처리 중 / 완료 / 보류 중 상태로 변경될 때 |
| **취소된 주문** | ✓ 선택됨 | POS 주문이 취소될 때                                 |
| **실패한 주문** | ✓ 선택됨 | POS 주문이 실패할 때 (결제 게이트웨이 오류 등)       |

### 고객 이메일[​](#customer-emails "고객 이메일으로 직접 링크")

*"POS 주문에 대한 WooCommerce 고객 알림 이메일"* — **기본적으로 활성화되어 있습니다.**

고객의 청구 이메일 주소로 발송됩니다 — 고객이 연결된 주문에 대해서만 발송되며, 게스트 판매의 경우 자동으로 생략됩니다.

| 이메일             | 기본값   | 발송 시점                            |
| ------------------ | -------- | ------------------------------------ |
| **보류 중인 주문** | ✓ 선택됨 | POS 주문이 보류 중 상태로 변경될 때  |
| **주문 처리 중**   | ✓ 선택됨 | POS 주문이 처리 중 상태로 변경될 때  |
| **주문 완료**      | ✓ 선택됨 | POS 주문이 완료될 때                 |
| **주문 환불**      | ✓ 선택됨 | POS 주문이 환불(전체 또는 부분)될 때 |
| **주문 실패**      | ✓ 선택됨 | POS 주문이 실패할 때                 |

### 캐셔 이메일[​](#cashier-emails "캐셔 이메일으로 직접 링크")

*"POS 주문을 처리한 캐셔에게 새 주문 알림을 전송합니다"* — **기본적으로 비활성화되어 있습니다.**

| 이메일      | 기본값                                  | 발송 시점                        |
| ----------- | --------------------------------------- | -------------------------------- |
| **새 주문** | ✓ 선택됨 *(마스터 토글이 켜져 있을 때)* | 해당 캐셔가 POS 주문을 완료할 때 |

WCPOS는 주문의 `_pos_user` 메타(계산대에 로그인한 WP 사용자)에서 캐셔를 식별하고 해당 계정 이메일을 가져옵니다. 캐셔 이메일이 관리자 이메일과 동일한 경우(예: 한 사람이 관리자와 캐셔를 겸하는 1인 매장) WCPOS는 수신자를 **중복 제거**하여 동일한 이메일이 두 번 발송되지 않도록 합니다.

관리자 및 캐셔 토글은 **독립적으로** 작동합니다. 하나를 끄더라도 다른 하나에는 영향을 미치지 않습니다.

## 일반적인 시나리오[​](#common-scenarios "일반적인 시나리오으로 직접 링크")

바쁜 날 받은편지함이 넘쳐나지 않게 하기

하루 매출이 50건 이상이고 관리자가 건건이 알림을 받을 필요가 없다면 **관리자 이메일 → 새 주문**을 끄세요. **취소된 주문**과 **실패한 주문**은 켜두세요 — 실제로 알아야 할 항목입니다.

매출 추적에는 새 주문 이메일 수를 세는 것보다 [보고서](/ko/reports/.md) 화면이 더 적합합니다.

관리자가 아닌 근무 중인 캐셔에게만 알림 보내기

**관리자 이메일** 마스터 토글을 끄고 **캐셔 이메일** 마스터 토글을 켜세요. 각 판매를 완료한 캐셔가 개인 계정 주소로 새 주문 이메일을 받게 되며, 관리자 받은편지함은 깨끗하게 유지됩니다.

캐셔가 여러 명인 매장에서 점주가 모든 거래에 대해 일일이 알림을 받고 싶지 않을 때 효과적입니다.

매장 내 판매에 대한 고객 이메일 비활성화하기

관광객이 많은 매장, 시장 노점, 퀵서비스 카페에서는 고객에게 영수증 이메일을 보내지 않는 경우가 많습니다 — 이미 인쇄된 영수증이 있기 때문입니다. **고객 이메일** 마스터 토글을 끄면 POS 판매에 대한 처리 중 / 완료됨 / 환불됨 이메일이 발송되지 않습니다.

온라인 주문의 고객용 이메일은 표준 WooCommerce 경로(POS 경로가 아님)를 통해 처리되므로 영향을 받지 않습니다.

고객 이메일은 켜두되 '처리 중' 이메일만 끄기

POS 주문이 즉시 완료되는 경우(현금 + 대면 카드 결제) 고객은 같은 순간에 *처리 중* 이메일*과* *완료됨* 이메일을 받게 됩니다. 고객 이메일 목록에서 **처리 중인 주문**의 체크를 해제하면 중복 이메일을 제거할 수 있습니다.

v1.8.9 이전 버전에서 업그레이드했더니 기존의 단일 '이메일 활성화' 스위치가 사라졌어요

이전 버전의 단일 on/off 스위치가 위의 세 그룹 구조로 대체되었습니다. WCPOS가 기존 설정을 자동으로 마이그레이션합니다 — 이전에 이메일을 꺼두었다면 세 개의 마스터 토글이 모두 꺼지고, 켜두었다면 관리자 및 고객 마스터 토글은 켜지고 캐셔는 꺼집니다(새 기본값).

별도의 작업이 필요하지 않습니다. 업그레이드 후 결제 설정 페이지를 열면 마이그레이션이 자동으로 실행됩니다.

## 개발자 훅[​](#developer-hooks "개발자 훅으로 직접 링크")

UI 외에 프로그래밍 방식으로 제어하려면 다음 WordPress 필터를 사용할 수 있습니다:

| 필터                                     | 용도                               |
| ---------------------------------------- | ---------------------------------- |
| `woocommerce_pos_admin_email_enabled`    | 관리자 마스터 토글 재정의          |
| `woocommerce_pos_customer_email_enabled` | 고객 마스터 토글 재정의            |
| `woocommerce_pos_admin_emails`           | 활성화된 관리자 이메일 목록 필터링 |
| `woocommerce_pos_customer_emails`        | 활성화된 고객 이메일 목록 필터링   |

캐셔 알림은 WooCommerce의 기존 `woocommerce_email_recipient_new_order` 필터를 통해 연결되므로, 수신자별 재정의(예: 추가 주소 참조 추가)가 다른 WooCommerce 이메일과 동일한 방식으로 작동합니다.

## 관련 문서[​](#related-documentation "관련 문서으로 직접 링크")

* [결제 설정](/ko/settings/wp-admin/checkout.md) — 동일한 설정 페이지의 결제 게이트웨이 및 주문 상태
* [주문](/ko/orders/.md) — 처리된 POS 주문 조회
* [캐셔 접근 권한](/ko/settings/wp-admin/access.md) — 캐셔로 로그인할 수 있는 WordPress 사용자