Paddle·Lemon Squeezy 한국 Checkout

한국어 checkout·KRW·현지 결제수단에서 두 플랫폼의 차이를 설명한다.

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

주제별 비교

비교 항목	Paddle	Lemon Squeezy
화면	Paddle.js overlay·inline·hosted 경로를 선택한다.	hosted checkout과 Lemon.js overlay를 선택한다.
한국 결제	KRW·한국 주소 등 조건에서 로컬 카드·KakaoPay·Naver Pay·Samsung Pay·Payco를 시험한다.	공식 목록에 해당 간편결제가 없으므로 카드·지원 지갑을 시험한다.
구독 결제	KakaoPay·Naver Pay 정기결제 지원을 시험한다.	카드·Apple Pay·Google Pay·PayPal 지원을 시험한다.
통화	KRW 판매 가격과 정산 통화를 분리한다.	KRW 표시와 USD 거래 처리, 지급 통화를 분리한다.

Paddle 상세

핵심 요약

초판은 Overlay Checkout으로 빠르게 출시하고 전환·이탈 데이터가 쌓인 뒤 Inline을 검토한다.
한국 결제수단(로컬 카드, KakaoPay, Naver Pay, Samsung Pay, Payco) 노출은 고객 국가·통화(KRW)·기기·dashboard 설정에 따라 달라지니 sandbox와 live에서 따로 검증한다.
결제수단 타입이 south_korea_local_card, kakao_pay 등으로 잘게 나뉘었으니 enum을 닫지 말고 unknown value도 저장·표시한다.
Korean local cards·KakaoPay·Naver Pay는 구독을 지원하지만 Samsung Pay·Payco는 현재 일회성 결제만 지원한다.
권한 부여는 결제수단이 아니라 transaction/subscription 상태를 기준으로 처리한다.
결제 주기·MoR 판매자 표시·해지·환불·세금을 한국어로 결제 직전에 명확히 고지한다.

한국 고객을 받는다면 Paddle Checkout을 영어 글로벌 결제창으로만 두지 마세요. 그러면 전환율도 떨어지고 CS도 늘어납니다. 한국 고객은 로컬 카드와 간편결제 기대치가 높고, 자동결제·환불·결제명 설명이 부족하면 결제 문의가 늘어납니다.

Overlay와 Inline 선택

방식	장점	주의점	권장 상황
Overlay Checkout	구현 빠름, Paddle UX 사용	앱 화면과 약간 분리됨	초판, 빠른 출시
Inline Checkout	앱 안에 자연스럽게 삽입	구현·QA 비용 증가	결제 전환 최적화 단계
Hosted Checkout	링크 기반 단순 운영	앱 내 상태 동기화 UX 약함	수동 견적/캠페인

초판은 Overlay로 시작하고 전환율·이탈 이벤트가 쌓인 뒤 Inline을 검토하는 방식이 가장 안전합니다.

Paddle은 한국 고객에게 한국 로컬 카드와 주요 간편결제를 제공합니다. Paddle 문서 기준으로 KakaoPay, Naver Pay, Samsung Pay, Payco, Korean local cards가 직접 결제수단으로 노출됩니다. 2025년 변경 이후로는 한국 결제수단이 checkout에서 개별 옵션으로 뜨고, 관련 API와 webhook도 개별 타입을 돌려줍니다.

결제수단	일회성	구독	운영 포인트
Korean local cards	지원	지원	구독 갱신과 저장 결제수단 표시 로직 확인
KakaoPay	지원	지원	구독 결제와 모바일 전환 흐름 테스트
Naver Pay	지원	지원	구독 결제와 인증 후 복귀 UX 확인
Samsung Pay	지원	미지원	일회성 상품, 지원 기기/브라우저 조건 확인
Payco	지원	미지원	일회성 상품, 결제 실패 메시지와 재시도 UX 확인

표시 조건

한국 결제수단 노출은 고객 국가, checkout 설정, 통화, 기기/브라우저, Paddle dashboard 설정에 따라 달라집니다. 한국 고객을 대상으로 팔 계획이라면 sandbox와 live에서 KRW 가격, 한국 국가 선택, 모바일 인증 복귀까지 따로 테스트하세요.

API 타입 변경 대응

예전에는 korea_local 같은 통합 타입을 썼지만, 최신 Paddle 문서에서는 한국 결제수단을 south_korea_local_card, kakao_pay, naver_pay, samsung_pay, payco처럼 잘게 나눕니다.

type PaddlePaymentMethodType =
  | 'card'
  | 'paypal'
  | 'south_korea_local_card'
  | 'kakao_pay'
  | 'naver_pay'
  | 'samsung_pay'
  | 'payco'
  | string

결제수단 타입은 enum을 닫아두지 말고 unknown value도 저장하고 표시할 수 있게 만드세요. 결제수단별 비즈니스 로직을 두더라도 권한 부여는 결제수단이 아니라 transaction/subscription 상태를 기준으로 처리합니다. KakaoPay와 Naver Pay는 구독 결제에서도 돌아오므로 billing 화면과 영수증 화면의 표시명을 따로 확인하세요. Samsung Pay와 Payco를 subscription checkout의 기대 결제수단으로 QA하지 않습니다.

한국어 결제 문구

가격 페이지와 결제 직전에는 다음을 명확히 보여줍니다.

결제 주기: 월간/연간 자동 갱신 여부
판매자: Paddle이 MoR로 처리하는 거래에서는 영수증에 Paddle 명칭이 표시될 수 있음
해지: 다음 갱신 전 언제까지 해지해야 하는지
환불: 환불 가능 기간, 제외 조건, 처리 채널
세금: 결제 단계에서 세금이 포함 또는 추가될 수 있음

QA 체크리스트

테스트	확인
한국 IP/한국 주소/KRW 가격	한국 결제수단 노출
모바일 브라우저	간편결제 인증 후 복귀
결제 성공	`transaction.completed`, `subscription.created` 수신
결제 실패	고객 메시지와 재시도 CTA
환불	권한 회수와 고객 안내
포털	결제수단 변경, 구독 취소, 인보이스 다운로드

상세 테스트 조합은 한국 Checkout QA 매트릭스에서 sandbox/live, KRW, 한국 주소, 모바일 인증 복귀 기준으로 관리합니다.

참고 자료

Lemon Squeezy 상세

핵심 요약

Checkout API의 checkout_options.locale에는 ko를 지정할 수 있다.
KRW는 지원 표시 통화지만 실제 거래는 USD로 처리된다고 공식 문서가 설명한다.
구독 결제수단은 카드, Apple Pay, Google Pay, PayPal로 제한된다.
공식 결제수단 목록에 KakaoPay·Naver Pay가 없으므로 지원한다고 안내하지 않는다.

Hosted checkout과 overlay

방식	사용 상황	QA 초점
Hosted checkout	구현이 단순하고 결제 화면을 분리할 때	앱→결제→복귀, 쿠키·세션, 모바일 브라우저
Lemon.js overlay	앱 안에서 결제 흐름을 이어갈 때	팝업 차단, 스크롤, 접근성, 복귀·닫기 이벤트

두 방식 모두 최종 결제와 권한의 근거는 서버 측 webhook/API입니다. Hosted checkout, overlay 문서에 따라 테스트합니다.

한국어·가격 설정

Create a checkout API는 Store와 Variant 관계를 지정합니다. checkout_options.locale: "ko"로 UI 언어를 고정할 수 있고, checkout_data.custom에 내부 사용자·워크스페이스의 불투명 식별자를 전달해 webhook과 연결할 수 있습니다. 민감한 개인정보나 권한 자체를 custom data에 넣지 않습니다.

{
  "data": {
    "type": "checkouts",
    "attributes": {
      "checkout_options": { "locale": "ko" },
      "checkout_data": { "custom": { "workspace_id": "ws_123" } },
      "preview": true
    },
    "relationships": {
      "store": { "data": { "type": "stores", "id": "STORE_ID" } },
      "variant": { "data": { "type": "variants", "id": "VARIANT_ID" } }
    }
  }
}

스토어 통화로 KRW를 선택할 수 있지만 Currencies는 checkout 거래를 USD로 처리한다고 명시합니다. 고객에게 표시된 KRW, 실제 USD 처리 금액, 카드사가 적용한 환율·해외결제 고지를 구분합니다. 최종 표시·청구액은 실제 checkout에서 확인합니다.

결제수단 안내

공식 Payment methods는 Visa·Mastercard·AmEx·JCB·UnionPay 등을 포함한 카드, PayPal, Apple Pay(Safari), Google Pay(Chrome), 일부 지역의 기타 지갑·은행 출금을 안내합니다. 노출은 국가·기기·상품 종류에 따라 달라집니다. 구독에는 카드·Apple Pay·Google Pay·PayPal만 지원됩니다. KakaoPay·Naver Pay·Samsung Pay·Payco는 이 공식 목록에서 확인되지 않아 제품 문구나 QA의 기대 결과에 넣지 않습니다.

고객에게 보여줄 문구

결제는 Lemon Squeezy가 처리합니다. 화면에 표시되는 결제 통화와
카드 청구 통화·환율은 다를 수 있으므로 최종 결제 화면을 확인해 주세요.
구독은 선택한 주기로 갱신되며 계정의 결제 관리에서 해지할 수 있습니다.

법무 검토 전의 문구 예시입니다. 결제 주기·세금·환불·청구 명세 표기는 실제 checkout 및 Buyer Terms와 일치시킵니다.

공식 출처

주제별 비교

비교 항목	Paddle	Lemon Squeezy
화면	Paddle.js overlay·inline·hosted 경로를 선택한다.	hosted checkout과 Lemon.js overlay를 선택한다.
한국 결제	KRW·한국 주소 등 조건에서 로컬 카드·KakaoPay·Naver Pay·Samsung Pay·Payco를 시험한다.	공식 목록에 해당 간편결제가 없으므로 카드·지원 지갑을 시험한다.
구독 결제	KakaoPay·Naver Pay 정기결제 지원을 시험한다.	카드·Apple Pay·Google Pay·PayPal 지원을 시험한다.
통화	KRW 판매 가격과 정산 통화를 분리한다.	KRW 표시와 USD 거래 처리, 지급 통화를 분리한다.

Paddle 상세

핵심 요약

초판은 Overlay Checkout으로 빠르게 출시하고 전환·이탈 데이터가 쌓인 뒤 Inline을 검토한다.
한국 결제수단(로컬 카드, KakaoPay, Naver Pay, Samsung Pay, Payco) 노출은 고객 국가·통화(KRW)·기기·dashboard 설정에 따라 달라지니 sandbox와 live에서 따로 검증한다.
결제수단 타입이 south_korea_local_card, kakao_pay 등으로 잘게 나뉘었으니 enum을 닫지 말고 unknown value도 저장·표시한다.
Korean local cards·KakaoPay·Naver Pay는 구독을 지원하지만 Samsung Pay·Payco는 현재 일회성 결제만 지원한다.
권한 부여는 결제수단이 아니라 transaction/subscription 상태를 기준으로 처리한다.
결제 주기·MoR 판매자 표시·해지·환불·세금을 한국어로 결제 직전에 명확히 고지한다.

Overlay와 Inline 선택

방식	장점	주의점	권장 상황
Overlay Checkout	구현 빠름, Paddle UX 사용	앱 화면과 약간 분리됨	초판, 빠른 출시
Inline Checkout	앱 안에 자연스럽게 삽입	구현·QA 비용 증가	결제 전환 최적화 단계
Hosted Checkout	링크 기반 단순 운영	앱 내 상태 동기화 UX 약함	수동 견적/캠페인

초판은 Overlay로 시작하고 전환율·이탈 이벤트가 쌓인 뒤 Inline을 검토하는 방식이 가장 안전합니다.

한국 결제수단

결제수단	일회성	구독	운영 포인트
Korean local cards	지원	지원	구독 갱신과 저장 결제수단 표시 로직 확인
KakaoPay	지원	지원	구독 결제와 모바일 전환 흐름 테스트
Naver Pay	지원	지원	구독 결제와 인증 후 복귀 UX 확인
Samsung Pay	지원	미지원	일회성 상품, 지원 기기/브라우저 조건 확인
Payco	지원	미지원	일회성 상품, 결제 실패 메시지와 재시도 UX 확인

표시 조건

API 타입 변경 대응

type PaddlePaymentMethodType =
  | 'card'
  | 'paypal'
  | 'south_korea_local_card'
  | 'kakao_pay'
  | 'naver_pay'
  | 'samsung_pay'
  | 'payco'
  | string

한국어 결제 문구

가격 페이지와 결제 직전에는 다음을 명확히 보여줍니다.

결제 주기: 월간/연간 자동 갱신 여부
판매자: Paddle이 MoR로 처리하는 거래에서는 영수증에 Paddle 명칭이 표시될 수 있음
해지: 다음 갱신 전 언제까지 해지해야 하는지
환불: 환불 가능 기간, 제외 조건, 처리 채널
세금: 결제 단계에서 세금이 포함 또는 추가될 수 있음

QA 체크리스트

테스트	확인
한국 IP/한국 주소/KRW 가격	한국 결제수단 노출
모바일 브라우저	간편결제 인증 후 복귀
결제 성공	`transaction.completed`, `subscription.created` 수신
결제 실패	고객 메시지와 재시도 CTA
환불	권한 회수와 고객 안내
포털	결제수단 변경, 구독 취소, 인보이스 다운로드

상세 테스트 조합은 한국 Checkout QA 매트릭스에서 sandbox/live, KRW, 한국 주소, 모바일 인증 복귀 기준으로 관리합니다.

참고 자료

Lemon Squeezy 상세

핵심 요약

Checkout API의 checkout_options.locale에는 ko를 지정할 수 있다.
KRW는 지원 표시 통화지만 실제 거래는 USD로 처리된다고 공식 문서가 설명한다.
구독 결제수단은 카드, Apple Pay, Google Pay, PayPal로 제한된다.
공식 결제수단 목록에 KakaoPay·Naver Pay가 없으므로 지원한다고 안내하지 않는다.

Hosted checkout과 overlay

방식	사용 상황	QA 초점
Hosted checkout	구현이 단순하고 결제 화면을 분리할 때	앱→결제→복귀, 쿠키·세션, 모바일 브라우저
Lemon.js overlay	앱 안에서 결제 흐름을 이어갈 때	팝업 차단, 스크롤, 접근성, 복귀·닫기 이벤트

두 방식 모두 최종 결제와 권한의 근거는 서버 측 webhook/API입니다. Hosted checkout, overlay 문서에 따라 테스트합니다.

한국어·가격 설정

{
  "data": {
    "type": "checkouts",
    "attributes": {
      "checkout_options": { "locale": "ko" },
      "checkout_data": { "custom": { "workspace_id": "ws_123" } },
      "preview": true
    },
    "relationships": {
      "store": { "data": { "type": "stores", "id": "STORE_ID" } },
      "variant": { "data": { "type": "variants", "id": "VARIANT_ID" } }
    }
  }
}

결제수단 안내

고객에게 보여줄 문구

결제는 Lemon Squeezy가 처리합니다. 화면에 표시되는 결제 통화와
카드 청구 통화·환율은 다를 수 있으므로 최종 결제 화면을 확인해 주세요.
구독은 선택한 주기로 갱신되며 계정의 결제 관리에서 해지할 수 있습니다.

법무 검토 전의 문구 예시입니다. 결제 주기·세금·환불·청구 명세 표기는 실제 checkout 및 Buyer Terms와 일치시킵니다.

한국 Checkout

주제별 비교

Paddle 상세

Overlay와 Inline 선택

한국 결제수단

API 타입 변경 대응

한국어 결제 문구

QA 체크리스트

참고 자료

Lemon Squeezy 상세

Hosted checkout과 overlay

한국어·가격 설정

결제수단 안내

고객에게 보여줄 문구

공식 출처

On this page

한국 Checkout

주제별 비교

Paddle 상세

Overlay와 Inline 선택

한국 결제수단

API 타입 변경 대응

한국어 결제 문구

QA 체크리스트

참고 자료

Lemon Squeezy 상세

Hosted checkout과 overlay

한국어·가격 설정

결제수단 안내

고객에게 보여줄 문구

공식 출처

On this page