웹훅

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

가상계좌 입금처럼 고객이 결제창을 닫은 뒤에 완료되는 거래가 있어요. 웹훅을 연결하면 고객의 브라우저가 닫혀 있어도 가맹점 서버에서 결제 상태 변화를 받을 수 있어요.

연동 예시

가상계좌 입금 알림을 받으면 가맹점 서버는 PG가 정한 방법으로 알림을 검증해요. 예를 들어 결제 승인 응답에서 받은 값과 알림 본문의 검증값을 비교하거나 서명 헤더를 확인하는 방식이 있어요.

결제 조회 API로 상점·주문·금액·현재 상태를 대조한 뒤 주문 상태를 바꿔요. 수신 주소로 요청이 왔다는 이유만으로 결제를 완료 처리하면 안 돼요.

리다이렉트와의 차이

리다이렉트는 고객의 브라우저가 다른 주소로 이동하는 것이고 웹훅은 서버 사이에 보내는 알림이에요. 고객이 성공 화면을 보지 못해도 결제가 처리됐을 수 있어요. 브라우저의 이동 결과와 서버에서 확인한 결제 상태를 연결해 관리해요.

같은 알림이 또 오면요?

PG가 전송을 다시 시도하면 같은 알림이 여러 번 올 수 있어요. 이벤트 식별자와 거래 처리 기록을 확인해 같은 결제의 상품을 두 번 출고하지 않도록 해요. PG가 정한 시간 안에 수신 응답을 보내고 처리 실패와 재전송 기록도 확인해요.

서명을 제공하는 이벤트는 서명을 검증해요. 서명이 없는 이벤트는 해당 PG가 안내하는 검증 절차를 따르고 결제 조회 결과와 대조해요.