Temu 파트너 플랫폼 API를 드롭쉬핑 플랫폼에 연동하는 작업을 진행했다. 단순한 API 연동이라고 생각했지만, 온보딩부터 프로덕션까지 약 2개월에 걸친 긴 여정이었다.
Table of contents
Open Table of contents
개요
해당 플랫폼은 여러 마켓플레이스에 상품을 동시에 등록/관리하는 드롭쉬핑 플랫폼이다. 기존에 여러 국내 마켓플레이스를 연동했고, 여기에 Temu를 추가하는 작업이다.
연동 범위:
- 상품 등록/수정/삭제
- 주문 수신/확인
- 배송 정보 업데이트
- 재고 동기화
온보딩 프로세스
1. 파트너 등록
Temu Partner Platform에 가입한다:
Sign up → 이메일 인증 → 사업자 정보 입력 → Onboarding 인증이메일 인증이 여러 단계로 나뉘어 있다:
- Sign up verification
- Onboarding verification
- New email verification
- Contact email verification
각 단계마다 별도 인증 메일이 오므로, 인증 누락 없이 모두 완료해야 한다.
2. API 접근 권한
파트너 등록이 완료되면 API 키가 발급된다. Temu API는 OAuth 2.0 기반이다:
Client ID + Client Secret → Access Token → API 호출Taxonomy API 검증
마켓플레이스 연동에서 가장 까다로운 부분이 카테고리(Taxonomy) 매핑이다.
문제
Temu의 카테고리 체계와 플랫폼의 내부 카테고리가 다르다:
플랫폼: 의류 > 여성 > 원피스
Temu: Women's Clothing > Dresses > Casual Dresses매핑 테이블을 만들어야 하고, Temu가 제공하는 Taxonomy API로 검증해야 한다.
Collection Run
Postman Collection을 사용해 Taxonomy API 전체를 검증했다:
Collection Run 결과:
├── 전체 카테고리 조회 — Pass
├── 하위 카테고리 조회 — Pass
├── 카테고리 속성 조회 — Partial (일부 필수 속성 누락)
└── 상품 등록 테스트 — Fail (카테고리 매핑 오류)Partner Support와 여러 차례 이메일을 주고받으며 매핑 오류를 수정했다.
기술 이슈
1. API 업데이트 빈도
Temu는 API를 자주 업데이트한다. 연동 기간 동안 4회의 API Updates 알림을 받았다:
01/29 — API Updates
02/09 — API Updates
03/03 — API Updates
03/15 — API Updates변경사항:
- 엔드포인트 추가/변경
- 필수 파라미터 변경
- Rate Limit 조정
- 새 기능 추가
API 버전 관리가 중요하다. 변경 알림 메일을 무시하면 갑자기 호출이 실패할 수 있다.
2. 반품/교환 워크플로우
Partner Support에서 Return Reasons & Workflow Specification 문서를 별도로 공유했다. 반품 사유 코드가 마켓플레이스마다 다르므로 매핑이 필요하다.
3. 인증서 갱신
Temu API는 mTLS를 사용하는 경우가 있어 인증서 관리가 필요하다.
연동 아키텍처
드롭쉬핑 플랫폼
├── Channel Adapter (Temu)
│ ├── Auth Module — OAuth 2.0 토큰 관리
│ ├── Product Sync — 상품 등록/수정
│ ├── Order Sync — 주문 수신/확인
│ ├── Shipping Sync — 배송 정보 전송
│ └── Category Mapper — Taxonomy 매핑
├── Queue (ActiveMQ)
│ └── 비동기 처리 — Rate Limit 대응
└── Database
└── 매핑 테이블 — 카테고리, 반품사유 등새 마켓플레이스를 추가할 때마다 Channel Adapter를 구현하는 구조다.
교훈
- 온보딩에 시간을 확보한다 — 가입부터 API 접근까지 1~2주 소요
- Taxonomy 매핑은 가장 오래 걸린다 — 카테고리 체계가 다르면 수동 매핑 불가피
- API 변경 알림을 구독한다 — Temu는 빈번하게 API를 업데이트한다
- Partner Support 응답은 느릴 수 있다 — 이메일 기반, 영어 커뮤니케이션, 시차 고려
정리
Temu 파트너 플랫폼 연동은 API 자체보다 온보딩과 Taxonomy 매핑에 시간이 많이 걸린다. 이미 다른 마켓플레이스를 연동한 경험이 있는 시스템이라면 Channel Adapter 패턴으로 빠르게 추가할 수 있지만, 마켓플레이스별 차이점은 결국 수동으로 해결해야 한다.