한국 Checkout 현지화

Paddle Checkout에서 한국 로컬 카드·KakaoPay·Naver Pay 노출 조건, Overlay/Inline 선택, 세분화된 결제수단 API 타입 대응, 한국어 결제 문구와 QA 기준을 정리한다.

핵심 요약

초판은 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, 한국 주소, 모바일 인증 복귀 기준으로 관리합니다.

참고 자료

핵심 요약

초판은 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, 한국 주소, 모바일 인증 복귀 기준으로 관리합니다.

Overlay와 Inline 선택

한국 결제수단

API 타입 변경 대응

한국어 결제 문구

QA 체크리스트

참고 자료

On this page

한국 Checkout 현지화

Overlay와 Inline 선택

한국 결제수단

API 타입 변경 대응

한국어 결제 문구

QA 체크리스트

참고 자료

On this page