에스크로

에스크로는 온라인 결제시구매자를 보호하기 위한 구매안전 서비스, 매매보호 서비스입니다. 에스크로 서비스를 이용하면 구매자는 안전하게 상품을 구매할 수 있으며, 판매자는 구매자가 상품을 받은 후에 결제대금을 받을 수 있습니다.

실물 상품을 현금으로 판매하는 경우 에스크로 서비스 가입은 의무이며, 쇼핑몰 메인페이지에 에스크로 인증 마크를 표시해야 합니다. 단, 카드 결제나 배송이 불필요한 거래는 에스크로 의무 적용 대상이 아닙니다.

에스크로 구매안전 서비스 신청은 PG사를 통해 발급받을 수 있습니다. 다음은 에스크로 서비스를 이용하는 방법입니다.

에스크로 신청

1
이용중인 PG사에 에스크로이용신청을 합니다.
2
신청하면 1~2일내에 발급 됩니다.
3
발급 받으신 후 통신판매업 신고를 신청합니다.
4
통신판매업 신고완료 후 카드사 심사를 진행합니다.

결제 요청

클라이언트에서결제 요청시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이니시스만 제공합니다string
      PG사가 제공하는 구매확정/구매거절을 위한 url로 구매자가 이 url을 통해 구매확정/거절을 진행합니다.
    • receipt_confirmed_atdate
      구매자가 구매 확정을 한 시간입니다.
    • receipt_revoked_atdate
      구매자가 구매 거절한 시각입니다.

구매자의 구매 확정

배송등록하거나 배송완료시 구매 확정 이메일을 발송합니다. 구매자는구매 확정또는구매 취소를 선택할 수 있습니다.

구매 확정을 선택하면 판매자는 결제대금을 받을 수 있습니다. 구매자가 구매 취소를 선택하면 결제대금은 환불됩니다. 만약 구매자가 구매 확정 또는 구매 취소를 하지 않으면,n일 뒤자동으로 구매 확정 처리됩니다.