연동가이드

예시 미리보기 ​

주의사항

예시에 사용된 이미지는 이해를 돕기 위해 만들어진 샘플 이미지예요.

프론트 플러그인 예시 ​

병원 ​

병원의 EMR과 연동하여 고객정보를 확인하고, 진료접수 및 진료비 수납 기능으로 활용할 수 있어요.

병원

학원 ​

학원 CRM 서비스들과 연동하여 학생정보를 입력받아 출석체크 및 학원비 수납 기능으로 활용할 수 있어요.

학원

피트니스 ​

회원 확인 뿐만 아니라 추가 용품 구매와 회원권 결제까지 활용할 수 있어요.

피트니스

뷰티 ​

뷰티 CRM 서비스들과 연동하여 예약고객을 확인하고, 적립, 할인, 결제 기능을 활용할 수 있어요.

뷰티

약국 ​

처방전을 스캔하고, 조제 비용 결제 기능을 활용할 수 있어요.

약국

브랜드 ​

각 브랜드의 고객정보를 확인하고 할인, 적립, 결제 기능을 활용할 수 있어요.

브랜드

토스 POS 플러그인 예시 ​

결제 플러그인 ​

  • 외부 결제수단 연동: 선불권, 기프티콘, 식권 등 다양한 결제수단 추가 가능
  • 결제 정보 연동: 플러그인에서 처리된 결제 정보가 Toss POS에 자동 저장

한국선불카드 연동 예시 한국선불카드 결제 화면한국선불카드 결제 완료

상품 관리 플러그인 ​

  • 상품 정보 조회: POS에 등록된 상품 정보 조회
  • 품절 관리: 상품 품절 상태 관리

POS 상품 관리 화면 상품 관리 인터페이스

주문 관리 플러그인 ​

  • 주문 생성: 테이블오더, 모바일오더 등 다양한 주문 방식 지원
    • Toss POS 상품ID 필수 입력
    • 결제 완료 시 결제수단 정보 입력 가능
  • 주문 정보 연동: 플러그인에서 생성된 주문이 Toss POS에 자동 추가
  • 상태 추적: 주문 상태 변경(호출/완료/취소) 이벤트 실시간 수신

POS 주문 관리 화면 주문 관리 인터페이스

테이블 관리 플러그인 ​

  • 테이블 정보 조회: POS에 설정된 테이블 정보 조회
  • 상태 관리: 테이블 상태(주문정보, 점유상태) 이벤트 활용
    • 웨이팅 시스템 연동
    • 예약 서비스 연동
  • 주문 연동: 플러그인에서 생성된 주문이 Toss POS에 자동 추가
  • 결제 연동: 결제 완료 시 결제수단 정보 입력 가능

POS 테이블 관리 화면 테이블 관리 인터페이스

Open API 예시 ​

Open API는 외부 솔루션 서버와 토스플레이스 서버가 통신하는 방식이에요. 앱이 설치된 매장의 기본 정보와 주문·결제·카탈로그·할인 정보를 조회하고, 지원되는 범위에서 주문·배달 데이터를 기록하거나 웹훅으로 상태 변화를 동기화할 수 있어요.

데이터 연동 구조 ​

외부 솔루션과 토스 POS의 Open API 데이터 연동 구조

  • API 요청: 외부 솔루션 서버에서 Open API를 호출해 앱이 설치된 매장의 데이터를 조회해요.
  • 데이터 기록: 주문 생성은 별도 승인을 받은 앱에서 사용할 수 있고, 배달 정보 등록·수정·완료는 Open API로 생성한 주문에만 지원돼요.
  • 웹훅 수신: 토스플레이스에서 발생한 주문·결제·상품 등의 지원 이벤트를 외부 솔루션 서버로 전달해요.

매장 운영 정보 ​

  • 매장: 매장명, 사업자등록번호, 주소, 영업시간 등 기본 정보를 조회하고 변경 이벤트를 받아요.
  • 카탈로그: 상품, 카테고리, 옵션 정보를 조회하고 생성·수정·삭제 이벤트를 받아요.
  • 할인: 상품 또는 카테고리에 자동 적용할 수 있는 할인 정책을 확인해요.

거래 정보 ​

  • 주문: 주문 내역과 상태를 조회해요. 주문 생성 권한을 받은 앱은 외부 주문을 토스 POS에 생성하고, Open API로 생성한 주문을 상태에 따라 수락·거절·취소할 수 있어요.
  • 결제: 주문별 결제 내역을 조회하고 승인·취소 이벤트를 받아요.
  • 배달: 배달 정보를 조회하고, Open API로 생성한 주문의 배달 정보를 등록·수정·완료 처리해요.

실시간 동기화 ​

개발자센터에 웹훅 수신 주소와 이벤트를 등록하면 주문·결제·상품 등의 변경 이벤트를 HTTP POST 요청으로 받아요. 여러 매장의 이벤트는 merchantId로 구분하고, x-toss-webhook-id를 기준으로 중복 처리를 방지해요.

적용 사례 ​

외부 주문을 토스 POS로 전달해요

주문 생성 권한을 받은 앱에서 사내 앱이나 ERP로 만든 주문을 토스 POS에 전달하고, 매장에서 결제를 이어서 진행해요.

적용 사례: 컴포즈커피 앱오더, 하이브 사내카페

매장 운영 데이터를 분석해요

주문·결제 데이터를 외부 솔루션에 연동해 매장 현황, 매출 리포트, 운영 분석에 활용해요.

적용 사례: 토더, 버핏그라운드

전자 가격표를 동기화해요

토스 POS의 상품·할인 정보를 조회해 ESL 전자 가격표의 상품명과 가격을 관리해요.

적용 사례: 한아원, 에브리씬, 텔리카

자세한 기능과 연동 방법은 Open API 소개와 웹훅 가이드를 참고하세요.