검수 및 배포하기
개요
개발이 완료되면 개발자센터를 통해 플러그인을 배포할 수 있어요.
플러그인 배포하기
플러그인 업로드
개발이 완료된 플러그인을 '라이브 배포' 트랙에 업로드해주세요.
검수 요청
- [검수 요청] 버튼을 눌러 검수를 요청해주세요. 검수 후 승인되어야 매장에 배포할 수 있어요.
- 검수는 매주 월·목요일(근무일 기준)에 진행돼요.
자체 로그 수집 권장
플러그인 이슈 발생 시 원인 파악을 위해 자체 로그 수집을 권장해요. Sentry 연동이 없거나 자체적으로 앱 로그를 수집하지 않으면 추후 운영 문제 해결이 어려워요. 토스플레이스에서는 파악된 이슈가 프론트/POS 시스템 개선이 필요한 경우에 한하여 지원이 가능해요.
업데이트
- 검수 승인 후 배포하면 해당 플러그인이 설치된 POS에 새 버전이 배포돼요.
- 즉시 반영: POS를 새로고침하거나 종료 후 다시 실행해 주세요.
플러그인을 매장에 설치하기
운영 가맹점에서 플러그인을 사용하려면 솔루션사, 토스플레이스, VAN 대리점이 아래 순서로 진행해요.
| 구분 | 역할 |
|---|---|
| 솔루션사 | 라이브 검수와 배포를 완료하고, 대리점 권한 연결에 필요한 정보를 토스플레이스에 전달해요. |
| 토스플레이스 | VAN 대리점이 플러그인을 조회하고 활성화할 수 있도록 권한을 연결해요. |
| VAN 대리점 | 토스플레이스 파트너스의 가맹점 관리에서 대상 플러그인의 사용 여부를 ON으로 설정해요. |
VAN 대리점 권한 연결 요청
플러그인 앱과 VAN 대리점을 연결하려면 아래 정보를 developer-support@tossplace.com으로 보내주세요.
- 플러그인 앱 이름 및 ID
- VAN 대리점 정보: 대리점명, 대리점 사업자번호
VAN 대리점이란?
VAN 대리점은 가맹점의 카드 단말기 등록과 프론트·POS 설치를 담당하는 토스플레이스의 파트너예요.
운영 환경에서 플러그인을 사용하려면 VAN 대리점이 토스플레이스 파트너스에서 플러그인을 활성화해야 해요. 단, 테스트 환경에서는 VAN 대리점 없이 개발자센터에서 직접 활성화할 수 있어요.
| 테스트 가맹점 | 라이브 가맹점 | |
|---|---|---|
| 활성화 주체 | 개발자센터에서 직접 ON/OFF | VAN 대리점이 토스플레이스 파트너스에서 활성화 |
| VAN 대리점 필요 여부 | 불필요 | 필요 |
담당 VAN 대리점을 모르는 경우
매장이 단말기를 도입할 당시 계약한 VAN사 또는 대리점에 문의해 주세요. 계약 정보를 확인하기 어렵다면 단말기 구매처나 판매처를 통해 담당 VAN 대리점을 확인할 수 있어요.
매장 직접 설치 가능 여부
- 현재: 매장에서 직접 설치 불가능 (VAN 대리점 통해서만 가능)
- 향후 계획: 플러그인 마켓플레이스 개발 예정 (매장에서 직접 선택/설치 가능)
자주 묻는 질문
개발자센터에 업로드 후 변경 사항을 어떻게 확인할 수 있나요 ?
A. 프론트는 [설정 > 토스 프론트 재시작]을 통해 새 플러그인을 받을 수 있고, POS는 새로고침 혹은 종료 후 재시작으로 최신 플러그인을 설치할 수 있어요.
어떤 기준으로 검수하나요 ?
A. 이 링크의 검수 기준을 확인해주세요.
테스트 할 때도 매번 심사를 받아야 하나요 ?
A. 아니요, 개발 중에는 검수 없이 테스트할 수 있어요.
- 개발 배포: 검수 없이 즉시 배포 가능 (최대 5개 단말기)
- 라이브 배포: 검수 후 모든 단말기에 배포
배포했는데 단말기에 반영이 안 돼요.
A. 배포 후 단말기에 반영되지 않는 경우, 아래 상황별로 확인해주세요.
1. 테스트 개발 배포 후 반영 안 되는 경우
- 해당 단말기가 테스트 단말기로 등록되어 있는지 확인해 주세요.
- 개발 배포는 테스트 단말기(최대 5대)에만 적용돼요.
- 프론트: 설정 → 토스 프론트 재시작을 진행해 주세요.
- POS: 새로고침하거나 종료 후 다시 실행해 주세요.
2. 라이브 배포 후 반영 안 되는 경우
- 해당 단말기가 테스트 단말기로 등록되어 있다면, 개발자센터에서 테스트 단말기 등록을 해제해 주세요. 테스트 단말기에는 라이브 버전이 적용되지 않아요.
- VAN 대리점에서 토스플레이스 파트너스에서 플러그인을 활성화했는지 확인해 주세요.
- 활성화 후에도 보이지 않는다면 프론트 재시작 → 재온보딩 → ACL 등록값 순서로 확인해 주세요.