한국 Checkout 현지화
한국 로컬 카드, 간편결제, 결제 문구, 주소·통화 조건
한국 고객을 포함한다면 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 화면과 영수증 화면에서 표시명을 별도로 확인합니다.
한국어 결제 문구
가격 페이지와 결제 직전에는 다음을 명확히 보여줍니다.
- 결제 주기: 월간/연간 자동 갱신 여부
- 판매자: Paddle이 MoR로 처리하는 거래에서는 영수증에 Paddle 명칭이 표시될 수 있음
- 해지: 다음 갱신 전 언제까지 해지해야 하는지
- 환불: 환불 가능 기간, 제외 조건, 처리 채널
- 세금: 결제 단계에서 세금이 포함 또는 추가될 수 있음
QA 체크리스트
| 테스트 | 확인 |
|---|---|
| 한국 IP/한국 주소/KRW 가격 | 한국 결제수단 노출 |
| 모바일 브라우저 | 간편결제 인증 후 복귀 |
| 결제 성공 | transaction.completed, subscription.created 수신 |
| 결제 실패 | 고객 메시지와 재시도 CTA |
| 환불 | 권한 회수와 고객 안내 |
| 포털 | 결제수단 변경, 구독 취소, 인보이스 다운로드 |
상세 테스트 조합은 한국 Checkout QA 매트릭스에서 sandbox/live, KRW, 한국 주소, 모바일 인증 복귀 기준으로 관리합니다.