Open API 서비스 설치하기

개요

Open API 앱은 서비스 코드를 통해 가맹점에 설치할 수 있어요. 솔루션사는 개발자센터에서 서비스 코드를 확인해 전달하고, 가맹점은 토스 POS에서 직접 앱을 연동해요.

서비스 설치 과정

1. 서비스 코드 확인

   • 개발자센터 → 내 애플리케이션(Open API) 에서 서비스 코드를 확인해요.

   

2. 가맹점에 서비스 코드 안내

   • 확인한 서비스 코드를 서비스를 설치할 가맹점에 전달해요.

3. 가맹점에서 서비스 코드 입력

   3-1. 서비스 연동 화면 진입

   • 가맹점은 토스 POS → 설정 → 기타설정 → 서비스 연동에 진입해요.
   • [서비스 코드로 연결] 버튼을 눌러요.

   

   3-2. 서비스 코드 입력

   • 안내받은 서비스 코드를 입력하면 서비스 설치가 완료돼요.

   

4. 설치 결과 확인

   • 서비스 설치 후 해당 매장의 merchantId로 Open API를 호출할 수 있어요.
   • 웹훅을 설정했다면 앱 웹훅 이벤트의 app.installation.created.v1으로 설치를 확인할 수 있어요.

토스 POS 없이 프론트만 운영하는 매장

토스 POS가 없는 매장에서는 서비스 코드를 직접 입력하지 않고, 프론트 플러그인 설치 과정과 동일하게 VAN 대리점을 통해 Open API 앱을 적용해요.