파트너 시스템 연동 가이드

프론트 플러그인을 파트너 시스템과 연동하는 방법을 안내합니다.

연동 전 필수 사항

파트너 시스템과 프론트 연동 시, 어떤 방식을 선택하든 다음 두 가지 구현이 필요합니다:

파트너사 서버 구현: 결제 데이터 관리, API 제공, 외부 시스템과의 통신 처리
파트너사 프론트 플러그인 구현: 토스플레이스가 제공하는 Plugin SDK를 활용하여 프론트 플러그인 웹 개발

1. 결제 단말기 모드

외부 시스템(서버)에서 프론트로 결제를 요청하는 경우에 적합합니다.

모드: 결제 단말기 모드
예시: 별도의 모바일 포스와 연동되는 결제 단말기
연동 방식: API

외부 시스템(서버)에서 프론트로 결제를 요청하는 방법은 서버 구현에 따라 자유롭게 선택하실 수 있습니다. 저희는 아래 3가지 방안을 권장하고 있습니다.

1. API Polling: 플러그인 웹에서 결제 목록을 조회하는 API를 1초마다 Polling 후 결제 진행
1. Websocket: 자체 서버에서 WS 서버를 띄우고, 플러그인 웹에서 해당 웹소켓 서버에 연결
1. SSE (Server Sent Events): 자체 서버에서 결제 요청 시, 플러그인 웹으로 SSE 이벤트 발송

2. 키오스크 모드

고객이 프론트에서 직접 결제를 진행하는 경우에 적합합니다.

모드: 키오스크 모드
예시: 셀프 키오스크, 무인 주문기
연동 방식: API

3. 클라이언트 모드

모드 : 클라이언트 모드
예시 : EMR 클라이언트, 자체 솔루션 (외부 시스템(클라이언트)에서 프론트 연동)
연동 방식 : Serial 유선, WebSocket