연동가이드

Appearance

토스 POS 연동 시작하기 ​

토스 POS 연동 방법 ​

토스 POS는 다음 두 가지 방법 중 하나를 선택하여 연동할 수 있어요.

1. POS 플러그인 SDK ​

POS 화면에 직접 UI를 추가하고 실시간 이벤트를 처리하고 싶은 경우에 적합해요.

특징:

  • 실시간 UI 확장 가능
  • POS 내부 데이터 활용
  • TypeScript 기반 개발 환경
  • 로컬 개발 환경 지원

적합한 사례: 배달앱 연동, 테이블 오더 연동, 외부 결제수단 추가

2. POS Open API ​

서버 간 데이터 동기화나 외부 시스템 연동이 필요한 경우에 적합해요.

특징:

  • 서버 간 안정적 연동
  • 주문, 매출 데이터 실시간 동기화
  • HTTP API 제공

적합한 사례: ERP 시스템 통합, 백오피스 시스템 연동, 매출 데이터 분석

자주 묻는 질문 ​

연동 방법 ​

Q. Plugin SDK와 Open API 중 어떤 것을 선택해야 하나요? ​

A. 용도에 따라 선택하시면 돼요.

  • Plugin SDK: POS 화면에 직접 UI를 추가하고 실시간 이벤트를 처리하고 싶은 경우
  • Open API: 서버 간 데이터 동기화나 외부 시스템 연동이 필요한 경우

플러그인 SDK 개발 환경 ​

Q. 로컬에서 POS 개발 환경을 구성할 수 있나요? ​

A. 네, POS Plugin SDK는 로컬 개발 환경을 지원해요. 테스트 가맹점 연결 후 로컬에서 개발하고 테스트할 수 있어요.

Q. TypeScript를 꼭 사용해야 하나요? ​

A. JavaScript도 사용 가능하지만, 타입 안전성과 개발 생산성을 위해 TypeScript 사용을 권장해요.

데이터 연동 ​

Q. 실시간으로 주문 데이터를 받을 수 있나요? ​

A. 네, 두 가지 방법이 있어요.

  • Plugin SDK: 이벤트 리스너로 실시간 데이터 수신
  • Open API: 웹훅 이벤트 등록을 통한 실시간 데이터 수신

Q. 과거 주문 데이터도 조회할 수 있나요? ​

A. 네, Plugin SDK와 Open API를 통해 기간별 주문 데이터를 조회할 수 있어요.

문의사항 ​

개발·연동 중 궁금한 점은 개발자 포럼에 남겨주세요. 다른 개발자의 질문과 답변도 확인할 수 있어요.

서비스 도입이나 사업 제휴 상담은 아래 제휴 문의로 남겨주세요.