Paddle→Lemon Squeezy 이전
Lemon Squeezy 공식 Paddle 이전 절차를 바탕으로 상품·고객·결제수단·구독 데이터를 옮기고 신규 판매 전환과 이중 청구 방지를 검증한다.
핵심 요약
- Lemon Squeezy는 Paddle의 상품, 고객, 결제수단, 거래, 구독, 쿠폰, 라이선스 이전을 공식 지원한다고 설명한다.
- 이전은 초기 데이터 수입과 신규 판매 전환·구독 재생성의 두 단계로 진행한다.
- 카드·결제수단 데이터는 자체 CSV로 다루지 말고 두 공급자의 보안 이전 절차를 이용한다.
- Paddle 구독 취소와 Lemon Squeezy 구독 생성 시점을 조정해 이중 청구를 막는다.
지원 범위와 선행 조건
Lemon Squeezy의 공식 이전 가이드는 다음 데이터의 이전을 안내합니다. 실제 스토어의 Paddle 제품 버전, 계약·국가·결제수단, 구독 상태별 가능 범위는 공급자와 확인해야 합니다.
| Paddle 데이터 | Lemon Squeezy 대상 | 내부 검증 |
|---|---|---|
| Products/Prices | Products/Variants | 상품·월/연 플랜·권한 매핑 |
| Customers | Customers | 중복 이메일·내부 workspace 연결 |
| Transactions | Orders | 과거 매출·환불 원장은 별도 보존 |
| Subscriptions | Subscriptions | 갱신일·금액·상태·결제수단 |
| Coupons | Discounts | 할인 조건·만료·적용 기간 |
| License Activations | License keys | 활성 장치·라이선스 상태 |
공식 가이드는 스토어 생성과 활성화를 선행 조건으로 둡니다. 신규 스토어의 Seller/Buyer Terms, 세금 카테고리, 지급 수단, test/live 환경을 먼저 검토합니다. 기존 Paddle 계약 종료·잔액·환불·chargeback 자료의 보관 의무도 별도 확인합니다.
1단계: 데이터 이전
- Lemon Squeezy 지원팀과 이전 범위·일정·담당자를 합의합니다.
- 공식 절차에 따라 Paddle에 결제수단 보안 이전을 요청합니다. 카드번호·토큰을 자사 파일이나 이메일로 받지 않습니다.
- 가이드에서 요구하는 Paddle 정보와 라이선스 export를 안전한 채널로 전달합니다. 가이드의 vendor ID·auth code 경로는 사용 중인 Paddle 계정 버전에서 실제로 유효한지 공급자에게 확인합니다.
- Lemon Squeezy가 데이터를 수입한 뒤
Product/Variant,Customer,Order,Subscription매핑표를 받거나 직접 검증합니다. - 공식 문서가 자동 수입되지 않는다고 명시한 상품 설명·미디어·파일·variant 세부 정보를 수동 보완합니다.
- test mode에서 신규 구매, 기존 고객의 portal, 갱신 실패, 취소·환불, 웹훅 권한 연결을 테스트합니다.
2단계: 신규 판매 전환
공식 절차는 양측이 import date를 합의하고, Lemon Squeezy에서 신규 판매를 시작한 뒤 최근 변경 데이터를 추가 수입하고 기존 구독을 재생성하도록 안내합니다. 같은 구독이 Paddle과 Lemon Squeezy 양쪽에서 자동 갱신되지 않도록 Paddle 구독 취소가 완료됐는지 확인합니다.
| 전환 시점 점검 | 증거 |
|---|---|
| 신규 checkout URL·API key 교체 | test/live 설정 및 소액 live 주문 |
| 제품 권한 ID 매핑 | 내부 사용자·workspace ↔ 신규 subscription ID |
| 이전 구독 갱신일·금액 | 양 공급자 snapshot·고객 안내 |
| 이전 공급자의 자동 갱신 중단 | 취소 상태·효력일·최종 청구일 |
| 신규 공급자의 첫 갱신 | invoice·webhook·권한·고객 영수증 |
| 이전·이후 정산 분리 | 공급자별 주문 원장·payout·은행 입금 |
전환 당일의 웹훅을 한 공급자만 기준으로 처리하지 않습니다. 내부 billing_provider와 external_subscription_id를 복합 식별자로 사용하고, 공급자별 서명 secret·이벤트 parser를 분리합니다. 일정 기간에는 두 공급자의 구독을 모두 읽되 동일 서비스 기간에 두 건의 청구가 잡히면 즉시 예외 큐로 보냅니다.
고객·재무 커뮤니케이션
- 고객에게 판매자/카드 명세명, 환불·지원 채널, Customer Portal, 다음 갱신일이 바뀐다는 점을 안내합니다.
- 과거 주문은 공식 가이드가 안내하는 My Orders 접근을 테스트하고, 이전 전 구매 문서와도 대조합니다.
- 이전 공급자의 미정산액·환불·분쟁은 종료 후에도 발생할 수 있으므로 월마감 원장을 합치지 않습니다.
- 한국 B2B 직접 계약과 세금계산서 고객은 자동 이전 대상인지 별도 검토합니다.
출고 게이트
- 양 공급자가 데이터·결제수단 이전 범위와 import date를 확인했다.
- 상품·가격·세금 카테고리·할인·라이선스의 누락과 차이를 해소했다.
- 기존 구독의 마지막 청구와 신규 구독의 첫 청구가 겹치지 않는다.
- 고객별 portal·영수증·문의 경로를 검증했다.
- 과거 Paddle 원장과 신규 Lemon Squeezy 원장을 각각 재현할 수 있다.
- rollback 조건과 고객 보상·지원 담당자를 기록했다.