웹훅 설정하기
부트페이 웹훅은 결제 승인 후 부트페이 서버에서 상점 서버로 결제 결과를 실시간으로 전달하는 기능입니다.
결제 상태 변경을 즉시 감지하고 서비스를 업데이트할 수 있습니다.
웹훅 vs 폴링
웹훅은 이벤트 발생 시 실시간으로 알림을 받는 방식으로, API를 반복 호출하는 폴링 방식보다 효율적입니다.
1
관리자 페이지 접속
Admin
부트페이 관리자에 로그인 후 개발자메뉴 > 개발자센터로 이동합니다.
설정 항목
웹훅설정버튼을 클릭하면 설정 페이지가 열립니다
2
웹훅 설정
Admin
웹훅 설정 페이지에서 다음 항목들을 설정합니다.
설정 항목
Webhook URL웹훅을 수신할 서버 엔드포인트 URL (https 권장)Content-Typeapplication/json 권장재시도 횟수전송 실패 시 재시도 횟수 (기본 3회, 최대 25회)
3
웹훅 수신 서버 구현
Server
상점 서버에서 웹훅을 수신하고 처리하는 엔드포인트를 구현합니다.
설정 항목
HTTP 200성공 응답을 반드시 반환해야 합니다타임아웃응답 시간이 30초를 초과하면 실패 처리됩니다서명 확인보안을 위해 웹훅 서명 검증을 권장합니다
4
웹훅 테스트
Server
설정 완료 후 테스트 결제를 진행하여 웹훅이 정상적으로 수신되는지 확인합니다.
설정 항목
로컬 테스트ngrok 등의 터널링 서비스를 활용할 수 있습니다
웹훅 수신 로그를 확인하여 정상 동작 여부를 검증하세요.
Node.js 예제
중요: 웹훅은 반드시 HTTP 200 응답을 반환해야 하며, 30초 내에 응답하지 않으면 타임아웃 처리됩니다. 보안을 위해 웹훅 서명 검증을 권장합니다.
