POPBill Developers
가이드

Webhook 유형

Webhook은 프로그램 공급사의 운영방식에 따라 "통합 URL"과 "개별 URL" 유형 중 선택하여 이용할 수 있습니다.

  • 통합 URL : 다수 고객사의 상태 변경 이벤트를 통합 URL 한 곳으로 수신합니다.
  • 개별 URL : 다수 고객사의 상태 변경 이벤트를 고객사의 개별 URL로 각각 수신합니다.
Webhook 통합 URL 방식과 개별 URL방식

자사 프로그램을 개발하여 단독으로 Event를 수신하는 경우 "개별 URL" 유형을 이용합니다.

등록방법

팝빌 Webhook은 Event를 수신을 위한 Callback URL 등록만으로 이용이 가능하며, 프로그램 공급사 또는 고객사에 서버 환경에 따라 강화된 보안 설정을 위한 HTTP 인증을 추가로 적용할 수 있습니다.

  • (필수) Callback URL : 실시간 상태 변경 Event 수신을 위한 서버 URL 정보입니다.
  • (선택) HTTP 인증 : 등록한 Webhook 수신 서버에서 추가적으로 HTTP 인증을 적용하기 위해 사용하는 정보입니다. [Header]

    - Basic : 수신 서버에서 Basic 인증을 수행하기 위한 ID와 Password 정보를 입력합니다. 등록한 Basic 인증정보는 Base64 인코딩하여 Request Header-"Authorization" 항목으로 전송됩니다.

    - API Key : 수신 서버에서 API Key 인증을 수행하기 위한 API Key 정보를 입력합니다. 등록한 API Key 인증정보는 Request Header-"X-Api-Key" 항목으로 전송됩니다.

SAP By Design-Webhook 수신이 필요한 경우 기술지원센터(1600-9854) 문의주시기 바랍니다.

1. 통합 URL

통합 URL은 프로그램 공급사가 "Webhook 등록" 신청절차를 통해 요청하여 팝빌이 직접 등록합니다. 팝빌은 신청완료 후 10분 이내에 신청한 담당자에게 등록 완료 메일을 전달합니다. [Webhook 등록] 신청하기

2. 개별 URL

개별 URL은 프로그램 공급사 또는 고객사가 Webhook Event를 수신할 팝빌 계정에 로그인하여 직접 등록합니다.

URL 유형 변경을 원하시는 경우 선행적으로 팝빌에 기존 URL 정보 해지를 요청하여 주시기 바랍니다.