가상계좌 관련 DEPOSIT CALLBACK
가상계좌 관련 DEPOSIT CALLBACK 웹훅에서 고객 계좌 송금한도와 같은 경우에는 웹훅이 두번 호출되나요? (DONE, WAITING_FOR_DEPOSIT)
https://docs.tosspayments.com/common/webhook#deposit_callback
만약 두번 호출된다면 status가 DONE일때 저희 비즈니스 로직을 처리하고, 이후 WAITING_FOR_DEPOSIT이 되었을때 다시 그 로직을 취소해야하는지 궁금합니다.
웹훅(Webhook) 연동하기 | 토스페이먼츠 개발자센터
웹훅 URL을 등록해서 데이터 변경에 대한 정보를 받아보세요.

10 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
네 두번 전달됩니다. 그래서 WAITING_FOR_DEPOSIT으로 오면 로직을 취소해 주셔야 합니다.
그럼 결제 만료기간은 그대로 적용되는건가요?
그리고 두번 전달되는 사이의 대략적인 term은 어떻게 되나요? 저희가 한번 로직이 처리되면 바로 사용가능한 거라서요
네 가상계좌 입금 유효기간은 그대로 유지가 됩니다.
WAITING_FOR_DEPOSIT 가 발생하는 것은 쉽게 설명 드리면 은행 망취소 같은 개념이라고 보시면 됩니다.
보통은 2분 안에 발생하는데 아주 드믈게 2분 이상인 경우도 있습니다.
저 이해가 안되는 것이 있습니다. 가상계좌에 돈이 들어와야 Done을 보내주시는 거 아닌가요? 돈이 이미 들어왔는데 은행망 취소가 되는 게 이해가 안 가서요
저희가 전달드리는 통보는, 은행에서 전달되는 것을 기준으로 보내드리는데요.
일부 은행사의 경우, 입금완료라고 통보하고, 이후 프로세스에 문제가 생기면, 입금에 문제가 있다고 다시 저희쪽으로 통보합니다.
그래서 토스페이먼츠에서 은행에서 전달하는 상태를 그대로 드렸을 시에,
은행에서 성공으로 전달 했으니 DONE 이라고 전달한 이후,
은행 쪽 문제로 은행이 입금오류 라고 전달 하면, 다시 WAITING_FOR_DEPOSIT 라고 보내드리는 거라고 이해해주시면 됩니다.
PIT STOP 님 설명처럼,
이러한 상황들이 보통 2분 안에 발생하게 됩니다.
답변 감사드려요. 저희는 그럼 처음 done 을 받았을때 시간 텀을 두고 결제 완료 후 처리를 하는식으로 구현해야 하는데요. 혹시 이런일의 빈도가 어느정도 일까요
네 오토마타님 답변감사드립니다!
넵 삭제했습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.