일반결제 가상계좌 웹훅 연동 시 상점관리자 페이지에 등록한 웹훅이 호출되지 않습니다.
안녕하세요, Javascript SDK를 이용한 토스페이먼츠 '일반결제 - 가상계좌' 결제 연동 후 웹훅 호출에 대해 문의드립니다.
(오늘 확인해보니 일반결제가 통합결제창으로 명칭이 변경된거 같더군요.)
우선 상점관리자 개발자센터 페이지에서 라이브/테스트 환경에 대한 웹훅 URL을 등록해 놓았습니다.
[이벤트 타입 - DEPOSIT_CALLBACK]
이후 테스트 환경에서 결제 내역을 바탕으로 웹훅 URL을 호출하여 전달되는 응답 데이터를 로그로 찍어보고자 합니다.
웹훅 URL이 호출되지 않는 것인지 서버상 로그를 확인할 수 없는 상황입니다.
서버의 방화벽 설정 상 80/443 포트와 토스페이먼츠에서 제공하고 있는 웹훅 IP 접근 제어 목록은 개방된 상태인데요.
추가로 저희쪽에서 확인해봐야 하는게 있을까요?
논외로 만약, 하나의 상점 아이디(mid)로 여러 사이트에서 사용할 웹훅 URL을 여러 개 설정이 가능한지도 문의드립니다.
예를 들어,
http(s)://abc.com 사이트의 쇼핑 관련 결제에 대한 웹훅은 http(s)://abc.com/payments/shop/webhook으로 설정하고,
예약 관련 결제에 대한 웹훅은 http(s)://abc.com/payments/rsv/webhook
http(s)://xyz.co.kr 사이트는 통합으로 http(s)://xyz.co.kr/payments/webhook.php으로 설정하듯 말이죠.
17 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.

1. 웹훅 발송 내역은 개발자센터-웹훅-테스트-웹훅목록에 이름을 클릭하면 상세 발송 내역확인 가능합니다.
첨부이미지와 같이 정상적으로 웹훅 발송되었습니다.

2. mid 한개에 여러 개 웹훅 설정은 가능합니다.
다만 등록된 모든 주소로 동시에 호출되기 때문에 각 수신된 곳에서 주문번호를 보고 해당 사이트에서 결제 요청된 것인지 판단하여 후속 처리하는 로직을 추가해주셔야 합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
답변 감사합니다. 14시 09분경 테스트 환경에서 가상계좌건을 추가로 생성하였고, '입금처리' 버튼 클릭 시 웹훅 요청이 들어오는지 가맹점상 서버 로그를 확인해본 결과 해당 웹훅에 대한 로그가 찍히지 않습니다.
요청이 제대로 들어가지 않는 것 같은데요. 확인이 가능할까요?

주문번호 복사 해서 남겨주시겠어요?
사진보고 하나씩 type 하면 오타 있을것 같아서 부탁 드립니다
네, 주문번호: 2303304229824772 입니다.
참고로, 결제창 호출 후 successUrl을 통해 결제 승인 API 까지 정상적으로 처리된 상태의 주문건입니다.
@henunim 테스트 환경 가상계좌 발급 프로세스를 새롭게 시도하고, 그 주문번호 공유 가능 하실까요?
네, 지금 바로 진행해보겠습니다.
새롭게 생성된 가맹점상 주문번호: 2303306799741167
가상계좌건으로 결제 정보를 생성했으며, 토스페이먼츠 상점관리자 페이지 테스트 결제내역에서 '입금처리' 버튼은 클릭하지 않았습니다.
@henunim 님 웹훅이 정상적으로 동작하지 않은 것 같습니다. 테스트 환경에 등록한 웹훅을 삭제하고 주소 재 등록하여 한번만 더 테스트해보시겠어요? 그래도 이상이 있으면 내부 확인이 필요할 것 같습니다.
웹훅 URL 재등록하여 다시 한번 시도해본 결과 토스페이먼츠 상점관리자 테스트 결제내역 페이지를 통해 이번에는 '취소' 버튼을 클릭해 보았는데요.
'취소'를 클릭했을 때에는 웹훅 URL이 동작합니다.
'입금처리' 버튼을 클릭할 때에만 동작하지 않네요...
취소 처리된 주문번호 : 2303306508560417
입금처리할 주문번호: 2303309804197460
입금처리는 다른 은행으로 테스트 부탁드려요. 테스트 환경에서 일부 은행 입금처리가 정상 동작하지 않기 때문입니다.
확인해보시면 입금 상태가 변경되지 않았을 것입니.
네, 맞습니다. 입금처리 버튼 클릭 시 결가 alert(modal? toltip?)은 '승인 되었습니다.'와 같이 출력되는데, 상태는 변경되지 않더군요.
다른 은행으로 테스트 해봐야겠습니다.

계속 '국민' 은행으로 가상계좌 결제를 시도했었는데, '신한' 은행으로 테스트해보니 잘되네요. 감사합니다. (내 시간... 🥲 )
토스페이먼츠 개발자센터를 통해 실시간으로 테스트 환경에서 가상계좌 웹훅이 지원되지 않는 은행사 목록을 볼 수 있는 페이지가 있을까요?
이게 테스트 환경이라 일정치가 않습니다. 이부분 양해 부탁드립니다.
그렇군요. 감사합니다.