상품·가격·세금

이 장은 두 서비스를 같은 주제에서 비교한 뒤 두 공급자의 상세 설명을 모두 담습니다. 기능 노출·계약 요율·국가별 결제수단은 계정과 시점에 따라 달라질 수 있으므로 실제 스토어와 각 절의 공식 출처를 확인하세요.

주제별 비교

Paddle 상세

Paddle 연동에서 가장 오래 남는 결정이 Product/Price 구조입니다. 코드를 짜기 전에 상품 카탈로그와 회계 분석 단위부터 정해 둬야 월마감, 환불, 권한 부여, 가격 변경이 흔들리지 않습니다.

기본 모델

SaaS 구독 카탈로그 예시

Product를 너무 잘게 쪼개면 권한 매핑은 쉬워지지만 가격 변경과 리포팅이 복잡해집니다. 반대로 하나의 Product에 전부 욱여넣으면 결제·권한·회계 분석 단위가 흐려집니다.

과금 패턴별 모델

순수 사용량 과금은 Paddle이 사용량 원장을 대신 보관한다고 가정하지 않습니다. 내부 metering과 immutable usage ledger를 원장으로 두고 Paddle에는 청구 시점의 line item을 전달합니다.

국가별 가격

Paddle은 country-specific price override를 제공합니다. 같은 Price를 기준으로 한국·일본·EU 등 국가마다 가격을 따로 조정할 수 있습니다.

세금 포함/별도 표시

Paddle은 MoR 거래의 국가별 거래세를 계산하지만, 가격 페이지 문구는 자사가 책임져야 합니다.

product.tax_category

Product API의 tax_category는 계정에 활성화된 과세 카테고리 중 하나를 지정하는 필수 필드입니다. SaaS라고 모든 상품을 기계적으로 saas로 두지 말고, 소프트웨어 구현·전문 서비스·교육·디지털 상품을 별도 Product로 분리합니다. 카테고리를 바꾸면 기존 subscription item의 세금 계산과 고객 청구액에 영향을 줄 수 있으므로 Finance 승인과 checkout preview를 거칩니다.

price.tax_mode

지역별로 세금 포함/별도 표시를 자동 결정하려면 지원되는 계정·가격에서 tax_mode: location을 검토합니다. 기존 internal, external, account_setting 가격과 섞여 있을 수 있으므로 API 응답을 기준으로 inventory를 만들고, B2C 표시가격·B2B VAT ID·country override 조합을 sandbox와 live에서 확인합니다.

원화 가격 sanity check

원화 가격은 미국 가격 × 환율로만 정하지 말고 세금 포함 표시, Paddle 수수료, 고정 수수료, 환불률까지 반영해 최소 가격을 다시 보세요. 아래 계산기는 가격 후보를 확정하는 장치가 아니라, 가격 하한을 빠르게 가늠해 보는 도구입니다.

가격 변경 원칙

• Price ID는 코드와 권한 매핑에 들어가므로 임의 삭제/재사용하지 않습니다.
• 기존 고객 grandfathering 여부를 가격 변경 전에 결정합니다.
• 연간 결제 고객에게 변경 가격이 언제 적용되는지 이메일과 포털에서 확인 가능해야 합니다.
• 국가별 가격 override는 환율보다 전환율·환불률·지원 비용 기준으로 조정합니다.

내부 데이터 모델

plans
- internal_plan_code
- paddle_product_id
- paddle_tax_category
- paddle_price_ids[]
- paddle_tax_modes[]
- entitlement_set
- display_name

subscriptions
- user_id / workspace_id
- paddle_customer_id
- paddle_subscription_id
- paddle_status
- current_price_id
- next_billed_at
- entitlement_snapshot

참고 자료

• Paddle Developer - Prices
• Paddle Developer - Products API
• Paddle Help - Taxable categories
• Paddle Developer - Automatic tax-inclusive/exclusive prices
• Paddle Developer - Supported currencies
• Paddle Developer - Localize prices
• Paddle Developer - SaaS billing patterns
• Paddle Developer - Usage-based billing for AI companies
• Paddle Developer - Paid trials

Lemon Squeezy 상세

카탈로그 모델

Variants는 기존 구매자 접근에 영향을 줄 수 있으므로, 판매 종료 때 삭제 대신 비활성화를 검토합니다. test와 live의 ID는 서로 다릅니다.

SaaS 카탈로그 예시

고객이 다른 variant로 옮길 때 기존 구독을 중복 생성하지 않도록 subscription update API의 변경·비례청구 옵션을 확인합니다.

가격 모델 선택

Pricing models은 standard, package, 구독용 volume·graduated 모델을 안내합니다. 구독은 quantity를 갱신 시점에 청구하거나 usage-based billing을 켜서 사용량을 후불 보고할 수 있습니다. usage 원장의 중복·누락 방지와 정정 정책을 별도로 설계합니다.

사용량 과금 운영 예시

Usage-based Billing은 네 가격 모델 모두에서 구독 사용량을 다음 갱신 때 후불 청구할 수 있다고 설명합니다. 사용량 과금 Variant의 checkout 첫 청구는 setup fee가 없으면 0이며, checkout에 보낸 quantity는 무시됩니다. 따라서 ‘가입 즉시 이번 달 예상 사용료 청구’로 안내하면 실제 결제와 어긋납니다.

집계 방식은 기간 내 합계, 기간 내 마지막 값, 기간과 무관한 마지막 값, 기간 내 최대값 중 선택합니다. 예를 들어 좌석 수를 마지막 값으로 보고할지, API 호출을 합계로 보고할지에 따라 청구액이 달라집니다. 다음을 제품 정책과 원장에 함께 저장합니다.

subscription_id · subscription_item_id · billing_period_start/end
meter_name · aggregation_mode · internal_usage_event_id
reported_quantity · report_time_utc · provider_usage_record_id
correction_reason · expected_next_invoice_amount · reviewer

이 필드는 자사 내부 설계 예시입니다. Usage record 객체는 subscription_item_id, 양의 정수 quantity, increment 또는 set action을 사용합니다. increment 재전송은 이중 가산 위험이 있으므로 내부 이벤트 ID로 중복을 차단하고, 마감 전 집계값과 Lemon Squeezy에 등록된 기록을 대사합니다. 과거 사용량 정정 가능 범위와 청구 후 환불 절차도 고객 약관에 맞춰 정합니다.

세금과 통화

Tax categories는 개인용 SaaS, 기업 전용 SaaS, 다운로드 소프트웨어 등 상품별 분류를 둡니다. 범용 SaaS를 기업에서도 쓴다는 이유만으로 기업 전용 분류를 고르지 않습니다. 법적 분류를 제품 설명과 대조하고 스토어 담당자에게 확인합니다.

Sales tax and VAT에서 국가별 세금 계산 원칙을 확인하고, checkout preview로 고객 국가·사업자 세금번호·할인·세금 포함 여부에 따른 최종 청구액을 검증합니다. checkout의 표시 통화와 USD 처리, 이후 은행 입금 통화를 같은 필드로 저장하면 안 됩니다.

catalog_version
store_id, product_id, variant_id, price_id
internal_plan_key, entitlement_level, billing_interval
store_display_currency, displayed_amount
checkout_preview_total, tax_amount, processed_usd_amount
active_from, retired_at, test_or_live

변경 관리

1. 상품·variant·세금 카테고리 변경 이유와 승인자를 기록합니다.
2. 신규 구매와 기존 구독의 가격 적용 시점을 분리합니다.
3. test mode에서 checkout preview, 첫 결제, 갱신, variant 변경을 검증합니다.
4. live 전환 시 새 ID 매핑과 이전 variant 판매 중단 여부를 리뷰합니다.

공식 출처

• Adding products
• Variants
• Pricing models
• Usage-based billing
• Tax categories
• Create a checkout
• Currencies