에스크로
에스크로는 온라인 결제시구매자를 보호하기 위한 구매안전 서비스, 매매보호 서비스입니다. 에스크로 서비스를 이용하면 구매자는 안전하게 상품을 구매할 수 있으며, 판매자는 구매자가 상품을 받은 후에 결제대금을 받을 수 있습니다.
실물 상품을 현금으로 판매하는 경우 에스크로 서비스 가입은 의무이며, 쇼핑몰 메인페이지에 에스크로 인증 마크를 표시해야 합니다. 단, 카드 결제나 배송이 불필요한 거래는 에스크로 의무 적용 대상이 아닙니다.
에스크로 구매안전 서비스 신청은 PG사를 통해 발급받을 수 있습니다. 다음은 에스크로 서비스를 이용하는 방법입니다.
에스크로 신청
결제 요청
클라이언트에서결제 요청시payload.escrow = true옵션을 추가합니다. 자동결제 방식은 에스크로 결제를 지원하지 않습니다.
배송등록
SDK 설치하기
먼저 연동할 서버사이드 SDK를 선택해주세요. SDK에 따라 가이드가 달라집니다.
배송등록 요청하기
요청 파라미터
- receipt_id필수string부트페이에서 부여하는 영수증 ID로 고유한 값을 가집니다. 이 값은 데이터베이스에 반드시 저장되어야 합니다.
- delivery_corp필수string택배사 코드명범위: 카드사 코드표예시: CJ대한통운
- tracking_number필수string송장 번호
- redirect_url이니시스만 지원string구매확정/구매거절 페이지 이후 넘어갈 URL로, 결과를 받아 처리할 수 있습니다. 이니시스만 지원합니다.
- user필수hash배송받는 구매자 정보
- username필수string배송 받는 구매자명
- email필수string구매자 이메일
- phone필수string구매자 전화번호
- address필수string배송받는 곳의 자세한 주소
- zipcode필수string배송받는 곳의 우편번호
- companyhash배송하는 업체 정보입니다.
- namestring회사명
- phonestring연락 가능한 회사 전화번호
- zipcodestring회사 주소 우편번호
- addr1string회사 도로명 주소
- addr2string회사 상세 주소
응답 파라미터
결제 조회와 동일하며, 아래escrow_data만 추가됩니다.
- escrow_datahash에스크로 결제일 경우 에스크로 정보를 리턴합니다.
- statusnumber에스크로 상태를 리턴합니다.
- status_localenumber에스크로 현재 상태에 대한 언어(locale)별 응답값
- shipping_started_atdate배송 시작 일자
- escrow_confirm_url이니시스만 제공합니다stringPG사가 제공하는 구매확정/구매거절을 위한 url로 구매자가 이 url을 통해 구매확정/거절을 진행합니다.
- receipt_confirmed_atdate구매자가 구매 확정을 한 시간입니다.
- receipt_revoked_atdate구매자가 구매 거절한 시각입니다.
구매자의 구매 확정
배송등록하거나 배송완료시 구매 확정 이메일을 발송합니다. 구매자는구매 확정또는구매 취소를 선택할 수 있습니다.
구매 확정을 선택하면 판매자는 결제대금을 받을 수 있습니다. 구매자가 구매 취소를 선택하면 결제대금은 환불됩니다. 만약 구매자가 구매 확정 또는 구매 취소를 하지 않으면,n일 뒤자동으로 구매 확정 처리됩니다.


