마켓플레이스 문서는 개인 고객보다 조직·거래처·셀러 단위의 규칙이 중요한 서비스에 맞아요. 일반 쇼핑몰처럼 상품과 주문만 붙이는 것이 아니라, 누가 어떤 조건으로 구매하고 정산을 어떻게 묶을지 먼저 정해야 해요.
정산 모델을 먼저 정해요
돈의 흐름이 플랫폼을 거치는지, PG가 분리정산하는지, 에스크로가 필요한지에 따라 계약과 구현이 달라져요.
어디부터 볼까요
| 상황 | 먼저 볼 것 |
|---|---|
| 거래처별 구매 한도와 승인 규칙이 있어요 | 그룹 한도 설정 |
| 회사·부서·파트너 조직이 구매 주체예요 | 그룹 생성 |
| 여러 주문을 월말에 묶어 청구해야 해요 | 정산 집계 설정 |
| 셀러가 상품을 올리고 플랫폼은 수수료를 받아요 | 이 페이지의 셀러형 마켓플레이스 |
| 개인 회원 주문만 있으면 돼요 | 체크아웃 개요로 가요 |
기본 모델
| 개념 | 역할 | 대표 API |
|---|---|---|
| 그룹 | 거래처·법인·부서·셀러 같은 정책 단위 | 그룹 생성, 그룹 목록 |
| 그룹 사용자 | 그룹 안에서 실제 주문하는 계정 | 구성원 추가, 구성원 제거 |
| 한도 | 구매 가능 금액·횟수·기간을 제한하는 규칙 | 한도 설정 |
| 정산 집계 | 여러 주문을 그룹 기준으로 묶는 설정 | 정산 집계 |
한 줄로 보면 그룹은 정책의 단위, 사용자는 실행의 단위, 한도는 통제의 단위, 집계는 정산의 단위예요.
구현 순서
마켓플레이스 흐름은 보통 아래 순서가 자연스러워요.
- 고객 개요에서 고객과 그룹의 관계를 잡아요.
- 그룹 생성으로 거래처나 셀러 단위를 만들어요.
- 구성원 추가로 실제 주문 주체를 연결해요.
- 한도 설정으로 조직별 통제 규칙을 붙여요.
- 정산 집계 설정으로 비용 집계 기준을 고정해요.
- 주문 개요에서 조회·취소·환불 운영과 연결해요.
셀러형 마켓플레이스
입점 셀러·강사·입점 매장처럼 제3자가 상품을 올리고 플랫폼이 중개료를 받는 구조라면 아래 판단이 추가돼요.
먼저 정할 것
- PG가 분리정산 또는 에스크로를 지원하는가
- 판매자별 정산 계좌와 수수료율을 어디서 관리할 것인가
- 환불이 발생하면 이번 정산에서 차감할지 다음 정산에서 상계할지
- 판매자 대시보드에 매출, 수수료, 순 정산금을 어떻게 보여줄 것인가
플랫폼이 돈을 직접 나눠주는 구조는 위험해요
플랫폼이 결제금을 받아 임의로 판매자에게 나눠주면 전자금융거래법 이슈가 생길 수 있어요. 셀러형 마켓플레이스는 PG 계약과 정산 모델을 먼저 확인한 뒤 구현해요.
연결 방식
| 단계 | 할 일 | 문서 |
|---|---|---|
| 판매자 등록 | 판매자 대표 계정을 고객으로 만들고 셀러 그룹에 연결해요 | 고객 등록, 그룹 생성 |
| 상품 등록 | 상품 ex_uid 에 내 상품 ID를 넣고, 상품-판매자 매핑은 내 DB 에 남겨요 (상품 등록 API 는 metadata 를 받지 않아요) |
상품 등록 |
| 체크아웃 | 여러 판매자 상품이 섞이면 아이템 단위 정산 정보를 남겨요 | 체크아웃 생성 |
| 웹훅 | 결제 완료·취소 이벤트를 받아 정산 예정 금액을 보정해요 | 웹훅 처리 가이드 |
| 취소·환불 | 환불 금액을 판매자 정산금에서 차감하거나 다음 정산에 상계해요 | 취소 요청 |
설계할 때 묻는 질문
- 그룹 변경 시 기존 주문·정산 이력은 어떤 그룹 기준으로 볼 것인가
- 사용자별 한도와 그룹 한도를 따로 둘 것인가
- 주문 전 단계에서 한도를 막을 것인가, 정산 단계에서 경고할 것인가
- 정산 집계 기준일과 환불 유보 기간을 어떻게 둘 것인가
- 셀러형이면 PG 계약·분리정산 파라미터·정산 리포트를 누가 관리할 것인가
