연동
웹훅은 왜 필요한가요?
결제 상태가 우리 서비스 밖에서 바뀌는 경우가 있기 때문입니다. 관리자에서 취소했을 때, 가상계좌에 입금이 들어왔을 때, 예약결제가 실행됐을 때는 우리 서버가 요청한 적이 없어도 상태가 바뀝니다. 웹훅은 그 변경을 우리 서버로 알려주는 통로입니다.
웹훅이 특히 중요한 세 장면
- 관리자 취소 — 부트페이 관리자에서 취소하면 우리 주문도 같이 바뀌어야 합니다.
- 가상계좌 입금 — 계좌 발급과 입금은 다른 시점이라 입금 완료는 웹훅으로만 알 수 있습니다.
- 예약결제 실행 — 예약해 둔 결제가 실제로 성공했는지 실패했는지가 웹훅으로 옵니다.
받을 때 두 가지를 확인합니다
첫째, 진짜 부트페이에서 온 요청인지 봅니다. 웹훅 주소는 외부에 열려 있어 누구나 요청을 보낼 수 있습니다. 부트페이 웹훅은 223.130.82.0/24 대역에서 오므로 이 대역을 허용하는 것으로 발신지 검증이 됩니다.
둘째, 같은 웹훅이 두 번 와도 결과가 꼬이지 않게 만듭니다. 응답이 늦거나 실패하면 부트페이가 재전송하기 때문에, 이미 처리한 건인지 확인하고 넘어가는 처리가 필요합니다.
기준입니다. 수수료와 심사 조건은 시점과 계약에 따라 달라질 수 있습니다.