가상계좌 결제 상태 웹훅에서 결제취소 / 입금 오류 구분 방법 문의
안녕하세요. 토스페이먼츠 API v1.0을 사용하고 있습니다.
가상계좌 결제 상태 웹훅 설명에 의하면, 버전 v1.4까지는 입금 오류가 발생하면 결제 상태가 DONE -> CANCELED로 변경된다고 하는데요.
그러나, 입금이 정상적으로 완료된 이후에 직접 결제취소한 경우에도 DONE -> CANCELD로 변경되는 것으로 이해했습니다.
그렇다면 두 가지 경우 모두 DONE -> CANCELED로 변경될텐데 이 두 경우를 어떻게 구분할 수 있나요?

9 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
직접 결제취소를 하신케이스와
직접 결제취소를 하지않았는데 취소가 된 케이스의 구분이라서
가맹점의 취소요청 자체가 있는지 없는지로 직관적으로 알 수 있는 내용인데요
상태값으로만 아셔야하는 특별한 사유가 있을까요?
아하 혹시나 상태값만으로도 구분할 수 있는 추가적인 방법이 있을지 궁금했습니다
만약, 없다면 말씀해주신 것처럼 저희 DB에 직접 취소한 기록이 있는지 확인하여 구분해야 할 것 같습니다
보통 DONE -> CANCELED 는 2분 이내에 발생합니다.
넵, 최종상태만으로는 판단이 어려우실 수 있으니 취소요청한 자체 기록을 함께 사용하시는게 좋습니다.
입금 후 자동으로 취소되는 케이스가 자주 발생하는 것은 아니지만 대비하시는 생각은 좋은판단이십니다.
가능하시다면 API 버전도 상위버전 사용을 고려도 해보시길바랍니다.
넵 친절한 답변 감사합니다!!
추가적인 질문이 있습니다!
고객 계좌에서 정상적으로 출금이 되었는데도
토스페이먼츠에서 정의하는 "입금 오류"로 인한 DONE -> CANCELED 웹훅이 호출되는 경우가 있을까요?
또한, 계좌 송금 한도 초과 / 네트워크 이슈라면 이미 고객의 뱅킹 앱에서 오류가 발생했을텐데
이 때도 무조건 DONE 웹훅은 호출된 다음 CANCELED 웹훅이 호출되는 게 맞을까요?
고객 계좌에서 정상적으로 출금이 되었는데도 토스페이먼츠에서 정의하는 "입금 오류"로 인한 DONE -> CANCELED 웹훅이 호출되는 경우가 있을까요?아예 없다고 말씀드릴수는 없지만 거의 발생하지 않습니다. 네 고객의 앱에서 오류가 발생하고 DONE->CANCELED 로 호출됩니다.
아하 넵넵! 답변 감사합니다!!
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.