안녕하세요, 가상계좌 로직에 관하여 질문드립니다.
가상계좌 웹훅의 이벤트타입을 DEPOSIT_CALLBACK 로 설정하면
충전시 요청으로
{
"createdAt": "2025-07-25T15:50:33.000000",
"secret": "...",
"orderId": "...",
"status": "DONE",
"transactionKey": "..."
}
의 데이터만오고있는데,
이때 orderId로 기존에 가상계좌를 신청한내용(금액, 성명 등)을 신뢰하여 단순 DONE이 오면 로직을 진행해도되는걸까요?
11 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
상점아이디 알려주세요
라이브거래인가요?
상점아이디는 idfarm9nnn 이고,
현재 테스트로 진행했습니다.
라이브와 테스트의 응답값의 구조가 다르지않은걸로 알아서 여쭤봅니다
@김차장
API 버전이 같다면 구조도 같은게 맞습니다
이때 orderId로 기존에 가상계좌를 신청한내용(금액, 성명 등)을 신뢰하여 단순 DONE이 오면 로직을 진행해도되는걸까요?
--> 네 맞습니다. 추가로 "secret" 필드도 함께 검증하시면 더 안전해집니다
가상계좌 결제창 연동하기 | 토스페이먼츠 개발자...
토스페이먼츠 가상계좌 결제창에서 가상계좌를 발급받고, 입금 결과를 웹훅으로 받는 방법입니다.
네,
제가 우려하는점은 5만원에대해 가상계좌발급을 신청했을때,
요청파라미터에 입금금액이없어서 5만원 보다 적은 금액을 입금하였을때 DONE이 오는가 가 우려사항이였습니다.
5만원보다 적은 금액을 입금할 수 없게 은행 차원에서 막히니
걱정안하셔도 됩니다
정확히 가격이 일치해야, 입금이 되고
일치하지 않으면 은행 차원에서 계좌 상태에 오류가 있다며 화면이 안넘어갑니다.
해당 내용을 "과오납" 이라고 표현하고있구요, 과오납 되는 경우는 결제가 실패합니다
감사합니다,
결론은 DEPOSIT_CALLBACK 로 웹훅을 설정할때,
1. 가상계좌 생성당시의 금액 등의 데이터를 orderId로 DB에 적재하고
2. 웹훅으로 수신된 데이터에 status가 DONE이라면
1번에서의 orderId로 금액 유저에게 지급하면 되는거로 이해했습니다.
저희는 현재 입금후 웹훅이 발송되는 시점까지 3분의 텀이 있는데,
마지막으로 status가 DONE이 오고난뒤 다른 status가 오는경우도 있을가요?
네, 은행 장애 시 망취소가 발생할 경우 waiting for deposit 발생할 수 있습니다.
이 경우, 고객에게 즉시 연락해서, 해당 은행 장애로 입금이 되지 않았고 환불된다고 알려주셔야 합니다.
가장 최근 발생한 사례로는 신한은행 서버 장애로 신한은행 입금 시 done->waiting for deposit이 발생했습니다.
3분 유예 후 웹훅 발송 설정을 하셨더라도, 이 부분 꼭 대응하셔야 합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.