가상계좌 웹훅 연동 질문
안녕하세요. 가상계좌 웹훅 연동에 대해 질문이 있습니다.
WAIT_FOR_DEPOSIT -> DONE -> WAIT_FOR_DEPOSIT으로 돌아가는 상황은 입금은 확인 됐는데 금액이 맞지 않아서 발생되는 상태라고 이해했습니다. 그러면 토스페이먼츠에서 연동한 웹훅 서버에 2번의 요청이 DONE, WAIT_FOR_DEPOSIT으로 보내지나요?

21 Replies
사용자가 발급된 가상계좌에 입금을 하면 설정하신 콜백url 로 DONE 응답을 드리고, 사용자의 계좌에 문제가 있거나 은행의 이슈가 있는 경우 입금취소 처리를 하게 됩니다. 입금취소를 은행에서 알려오면 저희는 WAITING_FOR_DEPOSIT 으로 응답을 드리게 됩니다.
중간 전달자의 역할만 하게 되는거군요
가상계좌로 입금처리가 되엇던게 문제가 생겨 입금취소 처리가 되면 이경우 환불절차는 어떻게 되나요?
여기서 말씀드리는 입금 취소는 은행에서 입금자체를 취소 처리한다고 보시면 됩니다. (구매자 계좌에서 출금 후 다시 입금 처리됨)
따라서 환불이 필요한 작업은 아닙니다. 입금전 상태로 돌린다고 생각하시면 됩니다.
가상계좌 입력 창에서 환불계좌를 받는 폼을 못봤는데 구매자 계좌에서 출금이 어떻게 되는지는 쇼핑몰에서 다룰 필요는 없다는 거죠?
네 해당작업은 은행에서 이루어집니다.
네 감사합니다. 이해가 됐어요.
저 다음은 에스크로와 관련해서 질문이 있습니다.
배송정보 등록 요청, 배송완료 등록 요청 2가지 종류가 있더라구요.
후자의 경우에는 쇼핑몰에서 토스로 API를 송신하면 토스에서 처리 이후 callback으로 완료요청이 들어오나요?
저희 에스크로 연동 매뉴얼을 보고 말씀하시는게 맞으실까요?
네 맞아요

"발송정보", "수령정보" 등록 이렇게 2가지로 분류됩니다.
제가보고 있는 파일이 맞는거죠?

혹시 어떤 링크를 보고 계실까요? 링크 남겨주시겠어요?
Google Docs
XPAY[기타]에스크로_v.2.0.docx
Xpay-기타-에스크로 Protocol and Core Function Specification Version 2.0 2023.07 목차 에스크로 서비스의 개요 3 연동 샘플 파일 구조 4 API를 통한 배송정보 등록 및 배송완료 등록 4 API URL 4 배송정보 등록 요청 파라미터 5 배송완료 등록 요청 파라미터 6 ▪ 배송정보 등록 및 배송완료 등록 응답 파라미터 6 처리결과 수신 7 처리결과 수신페이지 URL 등록 7 처리결과 전송 파라미터 7 Appendix. 발송택배사 코드...
기대리님이 말씀해주신 부분은 어디문서에 있나요?
루트 폴더가 다른곳이네요. 보고 계신 링크가 더 최신이 맞습니다.
제가 보고있는게 맞나보네요
그러면 위에서 질문드렸던
배송정보 등록 요청, 배송완료 등록 요청 2가지 종류가 있더라구요.
후자의 경우에는 쇼핑몰에서 토스로 API를 송신하면 토스에서 처리 이후 callback으로 완료요청이 들어오나요?
에 대해서 확인을 좀 해주실 수 있나요?
네 그 문서 기준으로 배송완료 등록은.. 제휴 택배사 외에 자체적인 택배사를 이용하시거나 직접 배송하는 경우에 완료처리하실 때 사용하시는거에요.
그래서 콜백 개념이 아니라 말그대로 배송을 가맹점에서 완료 확정처리한다고 보시면 됩니다.
그러면 토스페이먼츠에는 상태만 넘겨주는 용도다 라는 거네요
네 맞습니다.
네 감사합니다 🙂
네 그리고 추후에 문의 주실 때 주제가 바뀌면 새로 포스트를 열어주시겠어요?
포스트 주제 단위로 내용이 정리되어 있기도 하고 추후에 검색에 더 용이해서요. 😃