웹훅

왜 완료 화면만으로 부족한가요?

가상계좌 입금처럼 고객이 결제창을 닫은 뒤에 완료되는 거래가 있어요. 웹훅은 고객 브라우저가 열려 있지 않아도 서버가 나중의 변화를 알 수 있게 해줘요.

연동 예시

가상계좌 입금 알림을 받으면 상점 서버는 PG가 제공하는 검증 절차를 적용하고, 거래 조회로 주문·금액·상태를 맞춰 봐요. 확인한 결과로 주문 상태를 갱신해요. 주소를 알고 있는 누군가가 보낸 임의의 요청을 그대로 결제 완료로 믿으면 안 돼요.

리다이렉트와의 차이

리다이렉트는 고객 브라우저가 다른 주소로 이동하는 것이고, 웹훅은 서버 사이의 알림이에요. 고객이 성공 화면을 보지 못해도 거래가 처리됐을 수 있으므로 두 경로의 결과를 일관되게 관리해야 해요.

같은 알림이 또 오면요?

전송 실패 뒤 재시도 등으로 알림이 중복될 수 있어요. 같은 거래 알림으로 상품을 두 번 출고하지 않도록 처리 기록을 확인하세요. 서명 검증을 제공하지 않는 이벤트도 있으므로, 모든 웹훅이 같은 보안 필드를 가진다고 가정하지 마세요.