웹훅 이벤트 관련 문의
웹훅을 연결중에 궁금한게 있어서 남깁니다.
1. 결제 완료시 , 결제 취소시 모두 PAYMENT_STATUS_CHANGED 이벤트로 수신하고 status 에 담긴 정보로 완료|실패|만료 등을 판단하면 되는거죠?
2. 그렇다면 CANCEL_STATUS_CHANGED 이벤트는 언제 수신되는건가요?
3. 마지막으로 토스쪽에서 보내주는 이벤트나 헤더에 커스텀 변수를 넣는 방법이 혹시 있을까요?
간단히 예시를 들면 저희는 개발서버 / 고객 데모체험 서버 / 라이브서버 3개로 나눠 운영 되는데 해당 웹훅 이벤트가 어떤 사이트에서 발생한건지 구분할려고 합니다.
15 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1. 네.
2. 웹훅 이벤트는 원하는 이벤트만 선택해서 받으면 됩니다.
3. 해당 기능은 지원하지 않습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
2번 질문을 보태자면 어떤상황에서 CANCEL_STATUS_CHANGED 이벤트가 발생하는지 문의였습니다.
예시를 들자면
지금은 결제 취소가 가능한 상태이면 고객이 바로 할 수 있도록 해뒀는데 이걸 쓰면 결제 취소 접수 > 관리자가 확인 후 취소 승인
이런식으로 쓸수 있나해서요
답변은 담주에 달아주셔요~ 주말잘 보내세요
문서 설명을 보면 아시겠지만..
https://docs.tosspayments.com/guides/v2/webhook#cancel_status_changed
웹훅(Webhook) 연결하기 | 토스페이먼츠 개발자센터
토스페이먼츠 결제, 브랜드페이, 지급대행 상태에 변경사항이 있을 때 웹훅으로 실시간 업데이트를 받아보세요. 웹훅이란 데이터가 변경되었을 때 실시간으로 알림을 받을 수 있는 기능이에요.
해당 결제가 취소 되거나 취소 실패 했을때 웹훅이 발송 됩니다.
결제취소 접수 -> 관리자가 확인은
실제로는 결제 취소가 되지 않은 상태인것 같은데
이건 토스페이먼츠가 인지할 수 있는 영역은 아닌것 같고, 자체적으로 구현하셔야 하는 영역입니다.
@냥과장 제가 상황설명을 부족하게한듯하여 다시 문의드릴꼐요.
결제 수단과 관계없이 제가 구현한 페이지나 토스 테스트결제 내역에서 취소를 하면 이벤트는 PAYMENT_STATUS_CHANGED 으로만 수신되는것을 확인 했어요.
그럼 CANCEL_STATUS_CHANGED 이벤트는 어떤 결제의 취소에 반응하는건지 궁금한겁니다.

설명 드렸지만 모든 결제건의 취소에 대해 발송 되고요
발송 안된 케이스가 있다면 주문 번호 알려주세요
저희가 구현한 로직을 통해 취소한 주문정보입니다.
paymentKey : tfutu20240806144658f7qB7
orderId : 2024080614465455
토스 테스트 결제내역에서 취소한 주문정보입니다.
paymentKey : tfutu20240806144446euDm0
orderId : 2024080614443534
이 두건에 대해 CANCEL_STATUS_CHANGED 를 못받으신거죠?
웹훅 목록에서 전송 기록을 봐도 안보이는데 제가 뭔가 놓치고 있는걸까요?

@k.t Kim 님 처음 안내를 잘못드렸던것 같습니다.
CANCEL_STATUS_CHANGED 는 비동기 해외결제에서만 발생합니다.
해외결제를 사용하지 않으신다면 PAYMENT_STATUS_CHANGED 만 사용하시면 됩니다.
@냥과장 과장님은 잘 안내해 주신것 같은데... 아무튼 안내 감사합니다!