마켓플레이스

마켓플레이스 이해하기

마켓플레이스는 결제보다 그룹·한도·정산 모델을 먼저 정해요.

마켓플레이스 문서는 개인 고객보다 조직·거래처·셀러 단위의 규칙​​이 중요한 서비스에 맞아요. 일반 쇼핑몰처럼 상품과 주문만 붙이는 것이 아니라, 누가 어떤 조건으로 구매하고 정산을 어떻게 묶을지 먼저 정해야 해요.

핵심 요약

  • 그룹은 거래처, 법인, 부서, 셀러처럼 같은 정책을 적용할 단위예요.
  • 사용자는 실제 주문을 넣는 계정이고, 한 그룹에 여러 사용자가 들어갈 수 있어요.
  • 한도는 월별·사용자별·그룹별 구매를 통제하는 안전장치예요.
  • 정산 집계는 여러 주문을 그룹 기준으로 묶어 청구·정산하기 위한 운영 기능이에요.
  • 셀러가 여럿인 중개형 서비스라면 PG 분리정산 가능 여부를 코드보다 먼저 확인해야 해요.
정산 모델을 먼저 정해요

돈의 흐름이 플랫폼을 거치는지, PG가 분리정산하는지, 에스크로가 필요한지에 따라 계약과 구현이 달라져요.

이런 상황이라면

상황 먼저 볼 것
거래처별 구매 한도와 승인 규칙이 있어요 그룹 한도 설정
회사·부서·파트너 조직이 구매 주체예요 그룹 생성
여러 주문을 월말에 묶어 청구해야 해요 정산 집계 설정
셀러가 상품을 올리고 플랫폼은 수수료를 받아요 이 페이지의 셀러형 마켓플레이스
개인 회원 주문만 있으면 돼요 체크아웃 이해하기로 가요

기본 모델

개념 역할 대표 API
그룹 거래처·법인·부서·셀러 같은 정책 단위 그룹 생성, 그룹 목록
그룹 사용자 그룹 안에서 실제 주문하는 계정 구성원 추가, 구성원 제거
한도 구매 가능 금액·횟수·기간을 제한하는 규칙 한도 설정
정산 집계 여러 주문을 그룹 기준으로 묶는 설정 정산 집계

한 줄로 보면 그룹은 정책의 단위​, 사용자는 실행의 단위​, 한도는 통제의 단위​, 집계는 정산의 단위​​예요.

구현 순서

마켓플레이스 흐름은 보통 아래 순서가 자연스러워요.

  1. 고객 이해하기에서 고객과 그룹의 관계를 잡아요.
  2. 그룹 생성으로 거래처나 셀러 단위를 만들어요.
  3. 구성원 추가로 실제 주문 주체를 연결해요.
  4. 한도 설정으로 조직별 통제 규칙을 붙여요.
  5. 정산 집계 설정으로 비용 집계 기준을 고정해요.
  6. 주문 이해하기에서 조회·취소·환불 운영과 연결해요.

셀러형 마켓플레이스

입점 셀러·강사·입점 매장처럼 제3자가 상품을 올리고 플랫폼이 중개료를 받는 구조라면 아래 판단이 추가돼요.

먼저 정할 것

  • PG가 분리정산 또는 에스크로를 지원하는가
  • 판매자별 정산 계좌와 수수료율을 어디서 관리할 것인가
  • 환불이 발생하면 이번 정산에서 차감할지 다음 정산에서 상계할지
  • 판매자 대시보드에 매출, 수수료, 순 정산금을 어떻게 보여줄 것인가
플랫폼이 돈을 직접 나눠주는 구조는 위험해요

플랫폼이 결제금을 받아 임의로 판매자에게 나눠주면 전자금융거래법 이슈가 생길 수 있어요. 셀러형 마켓플레이스는 PG 계약과 정산 모델을 먼저 확인한 뒤 구현해요.

연결 방식

단계 할 일 문서
판매자 등록 판매자 대표 계정을 고객으로 만들고 셀러 그룹에 연결해요 고객 등록, 그룹 생성
상품 등록 상품에 metadata.seller_id 같은 판매자 식별값을 남겨요 상품 등록
체크아웃 여러 판매자 상품이 섞이면 아이템 단위 정산 정보를 남겨요 체크아웃 생성
웹훅 결제 완료·취소 이벤트를 받아 정산 예정 금액을 보정해요 웹훅 처리 가이드
취소·환불 환불 금액을 판매자 정산금에서 차감하거나 다음 정산에 상계해요 취소 요청

설계할 때 묻는 질문

  • 그룹 변경 시 기존 주문·정산 이력은 어떤 그룹 기준으로 볼 것인가
  • 사용자별 한도와 그룹 한도를 따로 둘 것인가
  • 주문 전 단계에서 한도를 막을 것인가, 정산 단계에서 경고할 것인가
  • 정산 집계 기준일과 환불 유보 기간을 어떻게 둘 것인가
  • 셀러형이면 PG 계약·분리정산 파라미터·정산 리포트를 누가 관리할 것인가

다음 단계

최신 글통합 결제 설정 이전 글서버 인증