웹훅 관련해서 디테일한 부분 질문입니다. 실제로 웹훅이 '발송' 되는 타이밍은
https://api.tosspayments.com/v1/payments/confirm 를 호출하고, response까지 받았을때 웹훅 발송이 시작 되는걸까요?
12 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
어떤 웹훅이냐에 따라 다른데요
저희 문서에 보시면 웹훅 발송시점이 자세하게 표현되어있어요
https://docs.tosspayments.com/guides/v2/webhook
웹훅(Webhook) 연결하기 | 토스페이먼츠 개발자센터
토스페이먼츠 결제, 브랜드페이, 지급대행 상태에 변경사항이 있을 때 웹훅으로 실시간 업데이트를 받아보세요.
이벤트 타입을 눌러서 웹훅 발송이 언제되는지 확인해보세요
아하 PAYMENT_STATUS_CHANGED 의 경우가 궁금했는데용
그중 제가 첨부 드린 progress => done 타이밍이 궁금했습니당

저건 https://api.tosspayments.com/v1/payments/confirm 로직이 성공되는 순간 발송된다고 보면 될까용?
성공한 결제건에 대해서 조회해보면
토스페이먼츠 결제조회 페이지에서
결제일시
2025-07-25 05:20:11
웹훅은
2025-07-25 05:20:12
이렇게 1초 정도 차이가 나고 도착했더라고용
정확히는 웹훅 도착 시각은 아니고 생성 시각입니당 네트워크 전송 시간은 배제하고 궁금해서용

네, 저희쪽 로직처리 이후에 바로 나간다고 보심됩니다.
인증~승인요청 까지는 IN_PROGRESS 이고
승인응답처리되면 DONE 로 바뀌어요
그런데 승인요청/승인응답 은 API 로 바로 응답받으실거라
웹훅 시간을 고려할 필요가 없어요
아하 글쿤용
가맹점 로직처리시 가장 우선순위 높은것이 승인응답입니다.
웹훅은 보조 자료로 쓰셔야하구요
아하 제가 여쭤본 이유가
웹훅을 보조 자료로 폴백 처리로 쓰고 있는데용
승인요청 API 이후 응답을 받고, 저희 디비 로직이 도는데.
승인요청 API 응답을 받기 전에
웹훅이 먼저 도착해서, 폴백이 오히려 먼저 돌아 버려서
메인 로직이 실패가 되어버린거 같아서 여쭤봤어용
그래서... 승인 로직이 돌고 + 승인 요청 응답이 다 된 다음에 웹훅이 발송 되는게 아니고
승인 로직만 다 돌았을때 웹훅이 발송된다면
이런 일이 재발할수 있을거 같아서용
승인 로직 + API 응답 후 웹훅이 아닌
승인 로직이 끝나면 웹훅 발송으로 이해하면 될까용?
네 승인 로직 돌고 웹훅이 나가는거라 API 응답보다 빠르게 받으실수도 있습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.