가상계좌/계좌이체 '에스크로' 결제 시 배송정보 등록 방법에 대한 문의
안녕하세요.
OpenJDK 1.8 버전의 Spring Framework 환경에서 개발된 숙박/체험 예약 홈페이지에서
에스크로 결제건의 배송정보 등록 방법에 대해 문의드립니다.
(해당 홈페이지는 2022년도 개발이 되었으며 일반결제 SDK 방식 결제를 연동한 상태입니다.)
홈페이지 이용자의 숙박/체험 상품 예약에 있어서 가상계좌 또는 계좌이체 수단으로 에스크로 결제가 이루어 졌을 때에는 배송정보를 기입해야만 토스페이먼츠측에서 정산(금액 지불(?))이 이루어지는 것으로 알고 있습니다.
이에 관련해서 현재는 토스페이먼츠 상점관리자 페이지를 통해 에스크로 결제건에 대한 배송정보를 직접 등록하고 있습니다.
이를 홈페이지를 통해 처리하기 위해서 당사 기획부서측으로부터 배송 등록 API 연동 매뉴얼을 전달받아 보았는데요.
(홈페이지 관리자 페이지를 통해서 배송정보 등록 예정입니다.)
매뉴얼 내용이 (구)모듈(XPay)에 관련된 것으로 확인되어, SDK 방식으로 결제를 연동한 경우 이용 가능한 API가 있는지 문의드립니다.
만약, 별도로 API 가이드 문서가 있다면 참고 링크 공유 부탁드리겠습니다.
추가적인 질문은 아래 기재해 놓겠습니다.
질의항목
1. 에스크로 결제 시 배송정보 등록 시점은 결제창 호출 시점이어야 하는지요? 만약, 그렇지 않다면 그 시점에 대해 알려주시기 바랍니다.
2. 테스트 환경이 제공되는지 궁금합니다.
3. 운영 정책상의 질의로써 쇼핑몰 형태가 아닌 숙박/체험 예약 홈페이지에서도 에스크로 결제를 사용했다면 배송정보 등록이 필수인지 궁금합니다.
참고자료
- 토스페이먼츠 에스크로 설명
https://docs.tosspayments.com/common/glossary/escrow
- 에스크로 배송등록 API 매뉴얼
https://drive.google.com/drive/u/0/folders/1hNAsndJSSMMH5IgSYE3GbPlbvS3NRMl8
내용 확인하시어 답변 부탁드립니다.에스크로 | 토스페이먼츠 개발자센터
에스크로(Escrow)는 고객이 온라인으로 제품을 구매할 때 지불한 돈을 PG사와 같은 제3자가 보관했다가, 고객이 제품을 정상적으로 받으면 상점에게 돈을 지급해 주는 시스템입니다. 에스크로는 '결제대금예치 서비스', '매매보호 서비스', '구매안전 서비스'라고 불리기도 합니다.
11 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1) SDK방식 결제를 쓰시더라도 에스크로 배송등록은 기존 XPAY 및 구상점관리자 (pgweb.tosspayments.com)에서 배송등록작업을 해주시면 됩니다.
에스크로 배송등록 API 매뉴얼
https://drive.google.com/drive/u/0/folders/1hNAsndJSSMMH5IgSYE3GbPlbvS3NRMl8 를 보시면
배송정보등록요청
배송완료등록요청
이렇게 두가지의 요청이 있는데, 실물상품의 배송이 되지 않아 송장번호거 없는 에스크로 거래는 배송완료등록요청을 진행하시면 됩니다.
2) SDK 방식 테스트 결제 후 배송등록도 테스트로 진행한다는 말씀이실까요?
3) 에스크로 관련 규정에 따르면 실물배송상품을 현금으로 구매할 경우에만 의무적용이 되는것으로 알고 있습니다 . (다만 저희는 각 가맹점의 상황을 알수 없기 때문에, 사업장의 업종과 상관없이 에스크로로 결제요청을 올리면 에스크로 처리를 합니다)
네, 맞습니다! 가능하다면 배송정보 등록 후 정상적으로 등록되었는지 확인도 가능했으면 좋겠습니다.
(응답 로그로라도...)
api 호출시에 성공인지 실패인지 응답 내려갑니다.
해당 홈페이지의 숙박/체험 예약정보는
상태가 존재하며 보통의 경우 아래와 같은 흐름으로 업무 처리가 진행됩니다.
예약확인중 > 예약승인 > 이용완료
모든 상태 변경에 대해서는 관리자 페이지를 통해 권한 인가자가 직접 처리를 해야합니다.
이 경우 이용완료 상태 변경 시점에 배송완료등록요청 기능을 사용하면 되는 것일까요?
배송정보로는 숙박 업소 소재지 또는 체험 업소 소재지를 이용할 예정입니다.
논리적으로는 이렇게 사용하시면 되는데, 배송완료 등록 요청시에 구매자에게 구매 확정 메일이 전달되고 고객이 구매확정을 하시도록 되어 있습니다.
판매하시는 물품이 배송과는 무관해 보이는데 이렇게 사용하시면 고객분들의 오해가 있을수 있는점도 고려부탁드립니다.
2) 테스트부분에 대해 추가 답변드리면
a. 저희쪽과 계약이 완료되어 실상점용 MID가 부여된 상태라면,
결제 : 테스트키로 진행
배송등록 : 테스트 URL https://pgweb.tosspayments.com:9091/pg/wmp/testadmin/jsp/escrow/rcvdlvinfo.jsp 로 진행
하는 형태로 하실수는 있습니다. 다만 에스크로 배송등록의 경우, 테스트 구상점관리자 접속을 해야하며 , 테스트 MID에 대한 셋팅확인도 필요하기 때문에 가급적 운영용 MID 로 배송등록 테스트를 진행하실것을 권고드립니다.
현재 운영되고 있는 홈페이지이기에, 실제 MID는 발급된 상황이로 보시면 됩니다!
또한, 홈페이지 환경설정상 결제창 연동 시 사용할 운영/테스트모드에 대한 키를 별도로 설정하게끔 되어 있습니다.
답변 참고하여 작업해보겠습니다. 감사합니다.
아, 결국 고객이 확정을 지어야만되는 것이군요.
만약, 고객이 오랜 기간 구매확정을 하지 않는 경우는 어떻게 되는지 알 수 있을까요?
숙박/체험 상품에 대한 이용은 완료했을 때를 가정한다면요...
배송등록을 완료후 구매자의 구매확정이 있을때 : 구매확정 + 1영업일에 가맹점 정산
배송등록 완료후 구매자의 아무런 행위가 없을때 : 배송완료등록일기준 +7영업일에 자동구매확정처리 및 정산됩니다.
그렇군요, 궁금증이 해결되었습니다.
위 답별들 참고하여 작업해보고 추가적인 문의는 새로운 포스트로 다루겠습니다.
감사합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.