Toss Place POS 연동

## 이 연동으로 보이는 것 - 매장 주문 건수 · 결제 금액 (당일 실시간) - **시간대별 매출** (0~23시) - **결제수단별 매출** — 카드 · 카카오페이 · 네이버페이 등 - 일 · 주 · 월별 기간 매출 - 모닝 대시보드 매출 지표, 매출 분석 화면 상세 오프라인 매장 매출을 보는 경로입니다. ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | Toss Place **가맹 등록 완료** | — | ⚠️ 선행 필수 | | **Open API 사용 신청** | Toss Place 파트너 포털 | **심사 필요** | | **Access Key** | 포털 → API 관리 → 앱 등록 | | | **Secret Key** | 같은 곳 | | | **Merchant ID** | 매장 연결 후 확인 | **6자리 숫자** | ## 발급 절차 ### 1. Open API 사용 신청 1. [Toss Place 파트너 포털](https://partners.tossplace.com) 에 로그인 2. **API 관리** → **앱 등록** 3. Open API 사용 신청 후 승인을 기다립니다 > 가맹 등록과 API 심사가 모두 필요해 **즉시 발급되지 않습니다.** 먼저 신청해 두세요. ### 2. Access Key · Secret Key 발급 앱 등록이 승인되면 포털에서 Access Key 와 Secret Key 를 확인할 수 있습니다. Secret Key 는 발급 시점에만 전체 값이 보이므로 즉시 보관하세요. ### 3. Merchant ID 확인 — 가장 자주 틀리는 부분 포털에서 **매장 연결** 절차를 진행하면 Merchant ID 가 발급됩니다. | 구분 | 자릿수 | 용도 | |---|---|---| | **Merchant ID** | **6자리** | ✅ 모닝인사이트에 입력하는 값 | | 매장고유번호 | 10자리 | ❌ POS 기기 로그인용. 이 값이 아닙니다 | > ⚠️ **POS 로그인에 쓰는 매장고유번호(10자리)를 넣으면 `401` 오류가 납니다.** > 반드시 포털에서 확인한 **6자리 Merchant ID** 를 입력하세요. ## 모닝인사이트에 입력 1. **설정 → 데이터 연동** 탭 2. **POS → Toss Place** 카드 클릭 3. 입력: - Access Key - Secret Key - Merchant ID (6자리) 4. **저장** → **연결 테스트** 연결 테스트가 성공하면 **매장명이 표시**됩니다. 표시된 매장명이 실제 매장과 일치하는지 확인하세요 — 다르면 Merchant ID 가 다른 매장입니다. ## 확인 방법 1. 연결 테스트에서 **매장명이 올바르게** 나오는지 2. **매출 분석** 화면에 당일 주문이 나오는지 3. 시간대별 매출이 실제 영업 시간과 맞는지 4. 결제수단 구분이 나오는지 주문은 **한국 시간(KST) 기준**으로 정리됩니다. 시간대별 매출이 이상하게 밀려 보이면 문의해 주세요. ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | `401` · Merchant 불일치 | POS **매장고유번호(10자리)** 를 입력 | 포털의 **6자리 Merchant ID** 로 교체 | | 연결 테스트에서 다른 매장명 | 다른 매장의 Merchant ID | 해당 매장의 ID 로 교체 | | 인증 실패 | Access/Secret Key 에 공백 포함 | 다시 붙여넣기 | | 데이터 없음 | Open API 심사 미완료 | 승인 후 재시도 | | 주문 시각이 어긋난다 | 시간대 변환 문제 | [문의](/news/guide/contact) | ## 제약 - 가맹 등록과 API 심사가 모두 필요합니다 - **매장이 여러 개면 매장별 Merchant ID 로 각각 연동**해야 합니다 - 취소·환불은 사후 반영됩니다 ## 관련 문서 - [Cafe24 연동](/news/guide/cafe24) — 온라인 매출 - [플랫폼별 사전 준비물](/news/guide/integration-checklist) - [연동이 실패할 때](/news/guide/trouble-integration)