결제 설정

결제 설정 모듈을 사용하면 Kuee를 Stripe와 완전히 통합할 수 있습니다 — 카드 결제, POS 단말기 관리, 자동 정산을 지원합니다. 이 가이드에서는 계정 설정, POS 단말기, 거래 내역, 고급 설정의 네 가지 탭을 모두 다룹니다.

결제 설정 접근

왼쪽 사이드바에서 시스템 설정 > 기본 설정을 클릭한 다음 상단의 결제 설정 탭을 선택합니다.

결제 설정에는 네 개의 탭이 있습니다:

계정 설정

미연결: Stripe 계정 연결하기

처음 사용 시 계정 설정 탭에 Stripe 계정 연결 온보딩 화면이 표시됩니다:

• Connect Stripe — Stripe Connect 온보딩 흐름으로 이동하여 Stripe Express 계정을 생성하거나 연결합니다
• 이미 계정이 있으신가요? 여기를 클릭하세요 — 이미 Stripe Express 계정이 있는 경우 이 링크를 통해 자동으로 검색하고 동기화합니다

Stripe 연결 단계:

1. 계정 설정 탭에서 Connect Stripe를 클릭합니다
2. Stripe 온보딩 양식을 작성합니다 (사업자명, 은행 계좌, 본인 인증 등)
3. 모든 단계를 제출합니다 — Stripe가 검토 후 자동으로 Kuee로 리디렉션합니다
4. 돌아오면 계정 설정 탭에 녹색 "계정 연결됨" 상태 카드가 표시됩니다

팁: 이미 Stripe Express 계정이 있는 경우 "이미 계정이 있으신가요? 여기를 클릭하세요"를 사용하여 자동 동기화할 수 있습니다 — 다시 등록할 필요가 없습니다.

온보딩 미완료

Stripe Connect 프로세스를 시작했지만 완료하지 않은 경우 (예: 중간에 브라우저를 닫은 경우) 시스템에 노란색 경고 배너가 표시됩니다.

사용 가능한 작업:

참고: 온보딩이 완전히 완료될 때까지 카드 결제와 Stripe Terminal을 사용할 수 없습니다.

계정 연결됨

성공적으로 연결되면 페이지에 녹색 계정 상태 카드가 표시됩니다:

사용 가능한 작업:

• 대시보드 열기 — 일회성 링크를 생성하여 새 탭에서 Stripe Express 대시보드를 엽니다 (지급금, 잔액 등 확인)
• 다시 연결 — 계정 연결 상태를 새로고침합니다

POS 단말기

POS 단말기 탭은 칩, 마그네틱 스트라이프, 비접촉(NFC) 결제를 지원하는 물리적 카드 리더기 장치를 관리합니다.

카드 리더기 최초 설정 (단계별 가이드)

카드 리더기를 수령한 후, 다음 단계를 따라 개봉부터 결제 수락까지 진행하세요:

1단계: 개봉 및 전원 켜기

1. 박스에서 리더기와 전원 케이블을 꺼냅니다
2. 전원 케이블을 연결하고 콘센트에 꽂습니다
3. 전원 버튼을 눌러 장치를 시작합니다 (첫 부팅은 1–2분 소요될 수 있습니다)
4. 장치가 자동으로 펌웨어 업데이트를 확인하고 설치합니다 (업데이트가 있으면 완료될 때까지 기다려 주세요)

2단계: Wi-Fi 연결

1. 리더기 터치스크린에서 설정(Settings) 메뉴로 이동합니다
2. Wi-Fi 또는 **네트워크(Network)**를 선택합니다
3. 목록에서 매장의 Wi-Fi 네트워크를 선택합니다
4. Wi-Fi 비밀번호를 입력하고 **연결(Connect)**을 탭합니다
5. 화면 상단에 Wi-Fi 연결 아이콘이 나타나는지 확인합니다

중요: 리더기가 정상적으로 작동하려면 안정적인 Wi-Fi 네트워크에 연결되어야 합니다. 공용 핫스팟 대신 매장 전용 네트워크를 사용하세요.

3단계: 등록 코드 받기

등록 코드는 물리적 장치를 Kuee 계정에 연결합니다. 리더기 모델에 따라 방법이 다릅니다:

WisePOS E:

1. 리더기 메인 화면에서 키 순서 0-7-1-3-9를 입력합니다
2. 화면에 고유한 등록 코드가 표시됩니다 (예: clever-word-phrase 형식)

Stripe Reader S700 / S710:

1. 리더기 터치스크린에서 **설정(Settings)**으로 이동합니다
2. **페어링 코드 생성(Generate Pairing Code)**을 탭합니다
3. 화면에 고유한 등록 코드가 표시됩니다

팁: 등록 코드는 일정 시간이 지나면 만료됩니다. 코드를 생성한 후 신속하게 다음 단계를 완료하세요.

4단계: Kuee에서 리더기 등록

1. Kuee에서 시스템 설정 > 기본 설정 > 결제 설정으로 이동합니다
2. POS 단말기 탭으로 전환합니다
3. 리더기 추가 버튼을 클릭합니다
4. 대화상자에서 3단계에서 받은 등록 코드를 입력합니다
5. 쉽게 식별할 수 있는 리더기 이름을 입력합니다 (예: "프론트 데스크 1", "룸 리더기")
6. 리더기 추가를 클릭하여 등록을 완료합니다

5단계: 연결 확인 및 테스트

1. 등록 후 리더기 목록에서 장치 상태가 온라인으로 표시되는지 확인합니다
2. 리더기가 정상적으로 작동하는지 확인하기 위해 소액 테스트 결제를 권장합니다
3. 상태가 "오프라인"으로 표시되면 리더기의 Wi-Fi 연결을 확인하고 Stripe에서 동기화를 클릭하여 상태를 새로고침합니다

완료! 리더기가 준비되었습니다. 이제 결제 시 "카드 결제"를 선택하여 리더기로 결제를 받을 수 있습니다.

리더기 목록

리더기 추가

오른쪽 상단의 리더기 추가를 클릭합니다:

1. 물리적 리더기 화면이나 Stripe 대시보드에서 등록 코드를 찾습니다
2. 대화상자에서 다음을 입력합니다:
   • 등록 코드 (필수)
   • 리더기 라벨 (선택, 예: "프런트 데스크 리더기")
3. 리더기 추가를 클릭하여 등록을 완료합니다

팁: 각 물리적 리더기에는 고유한 등록 코드가 있습니다. 한 번 등록하면 매장에 영구적으로 바인딩됩니다.

Stripe에서 동기화

Stripe에서 동기화를 클릭하면 Stripe에서 최신 리더기 상태를 자동으로 가져옵니다:

• 새 장치 → 목록에 추가
• 제거된 장치 → 목록에서 제거
• 상태 변경 (온라인/오프라인) → 자동 업데이트

거래 내역

거래 내역 탭은 Stripe Terminal 리더기를 통해 처리된 모든 카드 결제를 표시합니다.

요약 카드

선택한 기간의 네 가지 주요 지표가 상단에 표시됩니다:

조회 및 필터링

• 날짜 범위 — 기본값은 최근 7일이며, 클릭하여 사용자 정의 범위를 선택합니다
• 검색 — 키워드를 입력하여 특정 거래를 찾습니다
• 내보내기 — 거래 데이터를 다운로드합니다

거래 상태

참고: 거래 내역 탭은 Stripe Terminal 리더기를 통해 수금한 결제만 표시합니다. 현금 및 수동 입력 카드 결제는 주문 관리 모듈에서 확인하세요.

고급 설정

고급 설정 탭은 카드 리더기의 팁 구성을 제공합니다.

팁 구성

활성화하면 결제 시 카드 리더기 화면에 팁 옵션이 고객에게 표시됩니다.

구성 단계:

1. 리더기 팁 활성화 토글을 켭니다
2. 세 가지 사전 설정 팁 비율 옵션을 설정합니다 (예: 15%, 18%, 20%)
3. 설정 저장을 클릭합니다

참고:

• 세 가지 비율 옵션은 고유해야 하며 1-100 사이여야 합니다
• 사전 설정 외에도 고객은 "사용자 정의 금액"을 선택하여 원하는 팁을 입력할 수 있습니다
• 저장 후 설정은 몇 분 이내에 연결된 모든 리더기에 적용됩니다

Stripe 계정 설정하기

Kuee는 Stripe Express 계정을 사용합니다 — 우리 플랫폼을 통해 관리되는 특별한 유형의 Stripe 계정입니다. stripe.com에서 직접 Stripe 계정을 만들 필요가 없습니다. 대신 모든 설정은 Kuee의 결제 설정을 통해 처리됩니다.

Stripe Express 계정이란?

Stripe Express 계정은 일반 Stripe 계정과 다릅니다:

설정 단계

1. Kuee에서 시스템 설정 > 기본 설정 > 결제 설정으로 이동합니다
2. 계정 설정 탭에서 Connect Stripe를 클릭합니다
3. Stripe 호스팅 온보딩 양식으로 리디렉션되며, 다음 정보를 제공해야 합니다:
   • 사업 유형: 개인, 개인 사업자 또는 법인
   • 사업 정보: 상호명, 주소, 전화번호, 업종
   • 개인 정보: 책임자 이름, 생년월일, SSN 뒤 4자리 (또는 전체 EIN)
   • 은행 계좌: 지급금 수령을 위한 라우팅 번호와 계좌 번호
4. 모든 단계를 완료하고 제출을 클릭합니다
5. Stripe가 정보를 검토하고 자동으로 Kuee로 리디렉션합니다
6. 돌아오면 계정 설정 탭에 녹색 "계정 연결됨" 상태가 표시됩니다

검토 일정

• 대부분의 계정은 제출 시 즉시 승인됩니다
• 일부 경우 Stripe가 추가 서류를 요청할 수 있으며, 영업일 기준 1-2일의 검토 기간이 소요됩니다
• 검토 과정에서 Stripe로부터 이메일 알림을 받게 됩니다

이미 Stripe Express 계정이 있는 경우

이전에 다른 플랫폼을 통해 Stripe Express 계정을 만든 적이 있다면 계정 설정 탭에서 **"이미 계정이 있으신가요? 여기를 클릭하세요"**를 클릭하세요. Kuee가 자동으로 기존 계정을 검색하고 동기화합니다 — 다시 등록할 필요가 없습니다.

팁: 시작하기 전에 사업자 등록증(해당되는 경우), EIN 또는 SSN, 은행 계좌 정보를 준비하세요 — 온보딩 프로세스를 빠르게 진행할 수 있습니다.

카드 리더기 구매

클리닉에서 대면 카드 결제를 받으려면 Stripe 인증 카드 리더기를 구매해야 합니다.

구매 방법

Kuee는 Stripe Express 계정을 사용하므로 Stripe 대시보드에서 직접 리더기를 구매할 수 없습니다. 대신 Kuee 리더기 스토어를 통해 구매하세요:

Kuee 리더기 스토어 — 곧 출시 예정

Kuee 내에서 Stripe 인증 카드 리더기를 둘러보고, 주문하고, 배송을 추적할 수 있는 전용 리더기 스토어를 구축 중입니다. 호환되는 모든 스마트 리더기 모델을 지원하며 미국 주소로 배송됩니다.

당분간은 인앱 Kuee AI 어시스턴트 (오른쪽 하단)를 통해 지원팀에 문의하여 리더기 구매를 진행하세요. 적합한 모델을 선택하고 주문을 대행해 드리겠습니다.

지원되는 리더기 모델

Kuee는 Stripe의 서버 측 통합 (서버 구동)을 사용하므로 인터넷에 직접 연결되는 스마트 리더기만 지원됩니다. 휴대폰과 Bluetooth 페어링이 필요한 모바일 리더기(Stripe M2 등)는 Kuee와 호환되지 않습니다.

중요: Stripe M2 리더기는 Stripe의 모바일 SDK에서만 작동하는 모바일/Bluetooth 장치입니다. Kuee의 서버 측 결제 시스템에서는 지원되지 않습니다. 위에 나열된 스마트 리더기 중 하나를 선택하세요.

배송 및 설정

• 미국 내 배송은 일반적으로 영업일 기준 3-5일이 소요됩니다
• 장치를 수령한 후 전원을 켜고 Wi-Fi에 연결한 다음, Kuee의 POS 단말기 탭에서 등록 코드를 사용하여 바인딩을 완료합니다

팁: 장치 오작동 시 중단을 방지하기 위해 예비 리더기를 보유하는 것을 고려하세요.

결제 처리 수수료

수수료 구조를 이해하면 클리닉의 결제 비용을 더 잘 계획할 수 있습니다. 모든 수수료에는 결제 처리 및 플랫폼 서비스가 포함되어 있습니다 — 숨겨진 비용 없이 단일하고 투명한 요율입니다.

수수료 개요

수수료 상세

• 월 수수료 없음: 결제 처리에 대한 월 구독료가 없습니다
• 설정 수수료 없음: 계정 생성 및 연결은 완전히 무료입니다
• 숨겨진 수수료 없음: 거래가 발생할 때만 수수료가 부과됩니다
• 간단한 통합 가격: 위의 요율에는 모든 결제 처리 및 플랫폼 서비스 수수료가 포함되어 있습니다 — 보이는 그대로가 지불하는 금액입니다

수수료 예시

팁: 대부분의 클리닉에서 대면 카드 결제(2.8% + 5¢)가 가장 일반적인 거래 유형이며 가장 낮은 요율을 제공합니다. 최적의 요율을 위해 가능할 때마다 카드 리더기 사용을 권장하세요.

문제 해결 및 FAQ

리더기 문제

결제 문제

계정 문제

팁: 위의 해결 방법으로 문제가 해결되지 않으면 Kuee의 인앱 고객 서비스 기능을 통해 지원팀에 문의하세요.

모범 사례

Stripe Express 계정 설정:

• "Connect Stripe"를 클릭하기 전에 사업자 등록증, EIN/SSN, 은행 계좌 정보를 준비하세요 — 온보딩 프로세스를 빠르게 진행할 수 있습니다
• 검토 지연을 방지하기 위해 사업자 등록증에 있는 것과 동일한 상호명을 사용하세요
• 연결 후 "대시보드 열기"를 통해 정기적으로 Express 대시보드를 확인하여 지급금과 잔액을 모니터링하세요
• 은행 계좌를 변경하려면 Express 대시보드에서 업데이트하세요
• 다른 플랫폼에서 Stripe Express 계정이 이미 있는 경우 "이미 계정이 있으신가요?"를 사용하여 자동 동기화하세요

리더기 구매 및 관리:

• 클리닉에 적합한 리더기를 선택하세요: 대부분의 클리닉에는 WisePOS E, 프리미엄 경험에는 S700/S710
• 각 리더기에 설명적인 라벨을 부여하세요 (예: "프런트 데스크 1", "룸 리더기")
• 주기적으로 "Stripe에서 동기화"를 클릭하여 장치 상태를 최신으로 유지하세요
• 리더기가 오프라인으로 표시되면 배터리 수준과 Wi-Fi 연결을 확인하세요
• 리더기 펌웨어를 최신 상태로 유지하세요 — Stripe가 자동으로 업데이트를 푸시합니다

팁 설정:

• 업계 관례에 따른 팁 비율을 설정하세요 (예: 15%/18%/20%)
• 팁을 활성화하기 전에 직원에게 알려 질문이 있는 고객을 도울 수 있도록 하세요

비용 최적화:

• 가능할 때마다 대면 카드 결제를 권장하세요 — 2.8% + 5¢로 수동 입력 결제(3.5% + 30¢)보다 훨씬 낮은 요율입니다
• Stripe 대시보드에서 정기적으로 수수료 보고서를 검토하여 결제 비용 구조를 파악하세요