가상계좌 입금기한 만료 시 웹 훅 전송
웹훅 수신 시 status값이 WAITING FOR DEPOSIT 으로 들어오는 경우는
1. 입금오류
2. 입금기한만료
이렇게 두 가지로 나와 있는데, 입금오류 시에는 다시 입금을 받아야 되기 때문에 가상계좌 정보가 활성화가 되어야 하는걸로 이해가 됩니다.
그러면 입금기한 만료시에는 v1/payments/{paymentKey} API를 이용해서 virtualAccount 객체의 expired 값이 true 인 경우에 가상계좌 정보를 비활성화 처리하는 방식으로 진행이 되어야 할까요?
6 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
WAITING FOR DEPOSIT 으로 상태 웹훅으로 발송 되는 경우는 아래 입니다.
1. 가상계좌가 발급되어 입금이 가능한 상태일때
2. 입금오류가 있을때
입금 오류가 있을때, 가맹점 측에서 입금 처리 받을 수 있도록 조치 해야 하는것 맞습니다.
입금기한만료때는 웹훅 발송되지 않습니다.
https://docs.tosspayments.com/guides/webhook#deposit_callback
이 문서를 보고 있다면, "파란색"으로 표시된 상태가 웹훅발송 된다는 것을 보시면 되겠습니다.
웹훅(Webhook) 연결하기 | 토스페이먼츠 개발자센터
토스페이먼츠 결제, 브랜드페이, 지급대행 상태에 변경사항이 있을 때 웹훅으로 실시간 업데이트를 받아보세요. 웹훅이란 데이터가 변경되었을 때 실시간으로 알림을 받을 수 있는 기능이에요.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
아, 그럼 기한만료 일 때는 시스템 자체적으로 뭔가 처리를 하는 구조가 되야할까요? 가령 활성화 상태를 보여주는데 기한이 만료가 된 경우에는 별도 웹 훅이 전달되지 않으니 가상계좌 발급 시점의 dueDate 정보를 이용해서 자체 처리를 하는 형태로
네, 정확합니다.
dueDate 까지 입금이 없으면, 가상계좌가 만료되었다고 인지하시고 처리 하시면 되겠습니다.
넵. 감사합니다.👍