앱에 결제 기능 추가하기
내장된 Paddle 또는 Stripe 연동을 사용해 모든 Lovable 앱에서 구독 및 일회성 결제를 받으세요.
Lovable의 내장 결제 기능을 사용하면 구독과 일회성 결제로 앱을 수익화할 수 있습니다. Lovable이 계정 생성, 연결, 기술적 설정 관리 등 인프라를 모두 처리하므로 여러분은 제품 제작에만 집중할 수 있습니다.
내장 결제 기능은 현재 두 개의 결제 게이트웨이인 Paddle과 Stripe로 구동됩니다. Lovable에게 결제 기능을 추가해 달라고 요청하면, Lovable이 프로젝트를 분석해 두 가지 옵션을 모두 제시하거나 판매 품목에 따라 특정 제공업체를 추천합니다.
이용 자격
내장 결제는 디지털 제품과 소프트웨어를 지원합니다.
- 구독 티어가 있는 SaaS 앱
- 프리미엄 언락 또는 일회성 구매가 있는 소비자 앱
- 반복 접근 요금이 있는 멤버십 및 커뮤니티
- e-book, 템플릿, 강의, 음악 등의 디지털 다운로드
- API 접근 또는 사용량 기반 플랜이 있는 개발자 도구
실물 제품은 완전한 이커머스 스위트를 제공하는 Shopify 연동을 사용할 수 있습니다. Stripe로 구동되는 내장 결제도 사용할 수 있으나, 재고 및 물류는 별도로 관리해야 합니다.
제한 및 금지 상품
일부 제품 카테고리는 Paddle과 Stripe에서 제한되거나 금지됩니다. 제한 상품(특정 금융 서비스 또는 규제 산업 등)은 추가 심사가 필요할 수 있으며 승인이 보장되지 않습니다. 금지 상품(불법 상품 등)은 바로 거부됩니다.
자세한 내용은 Paddle의 acceptable use policy와 Stripe의 restricted businesses list를 참고하세요.
시작하기 전에
요구 사항
- Pro 플랜 이상: 내장 결제는 유료 Lovable 플랜이 필요합니다.
- Lovable Cloud: 내장 결제는 웹훅과 구독 데이터를 위해 Lovable Cloud를 사용합니다. Cloud가 아직 활성화되지 않았다면 설정 중에 활성화하도록 안내합니다.
- 인증 권장: 구매를 개별 사용자와 연결할 수 있도록 앱에 인증 기능이 있는 것이 좋습니다.
설정 방식
설정 흐름은 두 부분으로 구성됩니다.
- 설정 및 테스트: 결제 제공업체를 활성화하고, 상품과 가격을 만들고, 테스트 카드로 프리뷰에서 모든 것을 테스트합니다. 실제 결제는 이루어지지 않습니다.
- 라이브 전환: 제공업체의 검증 절차를 완료하고, 준비 상태 점검을 실행한 뒤 게시합니다. 라이브 전환 후에도 테스트 환경은 그대로 유지되어 라이브 환경과 함께 안전하게 테스트할 수 있습니다.
테스트 환경과 라이브 환경
Lovable은 프로젝트 사용 방식에 맞춰 두 개의 분리된 결제 환경을 관리합니다.
테스트 모드는 프로젝트를 프리뷰에서 사용할 때 적용됩니다. 체크아웃은 테스트 카드 번호만 받습니다. 실제 카드는 동작하지 않으며 실제 결제도 이루어지지 않습니다. 라이브 전환 전에 결제 흐름을 구축하고 모든 것이 제대로 동작하는지 검증하는 용도입니다.
라이브 모드는 게시된 앱에 적용됩니다. 체크아웃이 실제 카드를 처리하고 고객에게 실제 금액이 청구됩니다.
각 환경은 자체 상품, 가격, 거래 내역을 갖습니다. 프로젝트를 게시하면 상품과 가격이 테스트에서 라이브로 자동 동기화됩니다(게시 및 상품 동기화 참고).
프리뷰의 결제는 설정 직후 바로 동작합니다. 게시된 앱의 체크아웃은 라이브 전환 단계를 완료하기 전까지는 실제 결제를 처리하지 않습니다.
Payments 탭에는 테스트와 라이브 데이터를 전환하는 토글이 있습니다. 앱에서는 Lovable이 테스트 모드 배너를 추가하며, 이 배너는 프리뷰에서만 표시되고 게시된 사이트에서는 숨겨집니다.
라이브 전환 후에도 두 환경은 모두 유지됩니다. 새로운 상품과 변경 사항을 프리뷰에서 먼저 테스트한 뒤 라이브로 동기화할 수 있습니다.
결제 설정
제공업체 선택
Lovable은 프로젝트를 분석해 두 제공업체를 모두 제시하거나 추천안을 제공합니다. 제품이 한 제공업체의 정책상 제한되는 경우, Lovable이 다른 쪽으로 안내합니다. 비교는 다음과 같습니다.
| Paddle | Stripe | |
|---|---|---|
| 이용 자격 | 지원 국가의 디지털 제품 및 소프트웨어 | Stripe 지원 국가의 디지털 제품, 서비스, 실물 제품 |
| 장점 | 전담 merchant of record로 글로벌 세금 징수, 인보이스, 영수증 처리. 거래당 단순하고 예측 가능한 가격. | 거래별로 선택 가능한 merchant of record. 국내 판매 시 더 낮은 수수료. 디지털 제품 외에 서비스도 지원. |
| 비용 | 거래당 5.0% + 50¢, 월 사용료 없음 | 표준 Stripe pay-as-you-go 요금 |
| 추천 대상 | 글로벌 고객을 대상으로 하는 SaaS 앱 및 디지털 제품 | 서비스를 판매하거나 국내 시장을 타겟팅하거나 거래별 MOR 제어가 필요한 프로젝트 |
Paddle과 Stripe 모두 소액 결제에 대한 할인 요율을 제공합니다. Paddle의 경우 $10 미만 거래는 정액 10%로 부과되어 결제 수수료가 구매 금액의 10%를 넘지 않습니다. 자세한 내용은 Paddle's pricing과 Stripe's pricing을 참고하세요. Lovable을 통해 Stripe나 Paddle을 사용하는 비용은 해당 제공업체를 직접 설정하는 것과 동일합니다.
merchant of record (MOR)란?
merchant of record는 결제 처리와 세무 준수를 법적으로 책임지는 법인입니다. 제공업체가 MOR 역할을 할 때는 법적으로 판매자가 그들입니다. 세금을 자동으로 계산, 징수, 납부하고 인보이스와 영수증을 처리합니다. 여러분은 수수료를 제외한 금액을 정산받습니다.
Paddle은 전담 MOR입니다. 모든 거래가 merchant of record 서비스를 통해 처리됩니다. Stripe는 디지털 제품에 대해 거래별로 활성화할 수 있는 선택형 MOR(Managed Payments)을 제공합니다. Managed Payments는 Stripe의 표준 결제 처리보다 더 적은 국가에서 사용할 수 있습니다.
결제 활성화
Lovable에 결제 추가 요청
Lovable에 결제를 받고 싶다고 말하세요. 예시.
월 $29 구독을 포함하는 가격 페이지를 앱에 추가해줘.내 디지털 강의를 $197에 팔고 싶어. 체크아웃을 설정하고 라이브 전환 전에 테스트할 수 있게 해줘.Lovable이 사용 사례에 가장 적합한 제공업체를 제안하고 연동 활성화를 도와줍니다.
기능 개요 검토
제공업체의 기능과 가격을 요약한 Enable payments 다이얼로그가 표시됩니다. Continue를 클릭해 진행합니다.
계정 설정 폼 작성
Lovable이 결제 제공업체 계정 생성을 위한 짧은 폼을 표시합니다.
Paddle의 경우:
- Email address: 아직 Paddle에 등록되지 않은 이메일이어야 합니다. 이미 등록되어 있다면
yourname+lovable@gmail.com같은 plus alias를 사용하세요. plus alias로 보낸 메일은 메인 받은편지함(yourname@gmail.com)으로 자동 도착하므로 별도 계정이 필요하지 않습니다. - First and last name: 법적 이름(Lovable 계정에서 자동 입력됨).
- Project name: 사업자명 및 은행 명세서에 표시되는 statement descriptor로 사용됩니다.
- Acceptable use policy: Paddle의 acceptable use policy, 이용 약관, 개인정보 처리방침에 동의해야 합니다.
Stripe의 경우:
- Email address: Stripe 계정 등록에 사용됩니다(설정 이후 변경 불가).
- Name: 사업자명 또는 개인 이름.
- Country: 사업자가 등록된 국가.
상품과 가격 생성
Lovable에 판매할 항목을 알려주세요.
세 가지 가격 티어를 만들어줘: Starter는 월 $9, Pro는 월 $29, Enterprise는 월 $99.평생 이용을 위한 일회성 결제 $49를 만들어줘.Lovable이 상품과 가격을 만들고, 체크아웃 흐름을 구성하고, 앱에 UI 컴포넌트를 추가합니다. 할인과 체험판도 설정할 수 있습니다.
Pro 플랜에 14일 무료 체험을 추가해줘.첫 3개월 동안 유효한 20% 할인 코드 LAUNCH를 만들어줘.Payments 탭
결제가 활성화되면 프로젝트 툴바에 Payments 탭이 나타납니다. 포함된 항목:
- Environment toggle: 테스트와 라이브 데이터 전환
- Revenue analytics: 순 매출, 활성 구독, 7/30/90일 범위의 차트
- Transactions: 각 거래의 상품, 고객, 금액, 상태, 날짜
- Adjustments: 환불, 크레딧, 차지백. 각 항목에는 작업 유형, 금액, 사유, 상태, 날짜가 표시됩니다
- Go-live checklist: 실제 결제를 받기 위한 진행 상황 추적
체크아웃 외관(폰트, 색상, 로고)이나 결제 수단 구성처럼 Lovable이 관리하지 않는 설정은 Payments 탭에서 제공업체의 대시보드를 바로 열어 설정할 수 있습니다.
거래 및 구독 상태(active, trialing, canceled, past_due 등)는 Payments 탭에 표시됩니다. 사용 가능한 상태는 제공업체에 따라 다릅니다.
고객 포털
Paddle과 Stripe 모두 최종 사용자가 구독을 취소하고, 결제 수단을 업데이트하고, 인보이스를 볼 수 있는 호스팅 고객 포털을 제공합니다. 추가하려면.
고객 포털을 여는 Manage subscription 버튼을 추가해줘.고객 포털은 새 브라우저 탭에서 열리며 iframe 안에 삽입할 수 없습니다. Lovable 프리뷰 패널 안에서는 동작하지 않습니다. 배포된 사이트를 독립 브라우저 탭에서 열어 테스트하세요.
체크아웃 표시 모드
Paddle은 두 가지 체크아웃 모드를 지원합니다.
- Overlay(기본): 현재 페이지 위에 모달이 표시됩니다.
- Inline: 체크아웃이 페이지 레이아웃 안에 삽입됩니다.
Lovable에 전환을 요청하세요.
가격 페이지에서 체크아웃을 모달이 아니라 inline으로 보여줘.Stripe는 embedded checkout만 사용합니다. 체크아웃 폼이 페이지에 직접 삽입됩니다. Lovable을 통해 커스터마이징할 수 없습니다. 스타일 변경은 Stripe 대시보드에서 구성해야 합니다.
테스트
설정 직후 테스트 환경이 활성화됩니다. 라이브 전환 전에 프리뷰에서 전체 결제 흐름을 테스트하세요.
테스트 카드
| 카드 번호 | 결과 |
|---|---|
| 4242 4242 4242 4242 | 성공 결제 |
| 4000 0000 0000 3220 | 3D Secure 결제 |
| 4000 0000 0000 0002 | 실패 결제 |
미래 만료일, 아무 3자리 CVV/CVC, 아무 청구지 주소를 사용하세요.
Lovable은 프리뷰에서만 보이는 테스트 모드 배너를 앱에 자동으로 추가합니다.
테스트할 항목
비즈니스 로직이 처음부터 끝까지 동작하는지 확인하세요.
- 테스트 구매를 완료하고 올바른 기능이 언락되는지 확인합니다.
- 권한, 모달, 알림, 리다이렉트가 모두 예상대로 동작하는지 확인합니다.
- Payments 탭에서 거래를 검토합니다.
테스트 모드에서는 전체 결제 주기를 기다리지 않고도 구독 갱신을 시뮬레이션할 수 있습니다. Lovable에 "구독 갱신을 어떻게 테스트하나요?"라고 물어보세요.
고려할 시나리오
- 업그레이드와 다운그레이드: 티어를 전환하면 올바른 기능이 부여되나요?
- 취소: 사용자가 결제 주기 종료까지 접근 권한을 유지하나요?
- 갱신: 구독이 갱신되고 접근 권한이 계속 부여되나요?
- 결제 실패: 앱이
past_due상태를 잘 처리하나요? - 체험: trialing 사용자가 접근 권한을 얻고, 체험 종료 후 결제가 올바르게 시작되나요?
- 할인 코드: 체크아웃에서 할인된 가격이 올바르게 적용되나요?
라이브 전환
앱이 실제 결제를 받을 준비가 되면 Payments 탭을 열고 go-live 체크리스트를 따르세요.
모든 라이브 전환 단계를 완료하기 전까지는 라이브 체크아웃이 동작하지 않습니다.
Paddle로 라이브 전환
준비 상태 점검
Run check을 클릭합니다. Lovable이 라이브 사이트를 검토해 다음을 확인합니다.
- 개인정보 처리방침 존재 여부
- 이용 약관 존재 여부
- 환불 정책 존재 여부
- 사이트 콘텐츠가 진정성 있고 Paddle 정책을 준수하는지
점검이 실패하면 대시보드에 수정 방법이 표시됩니다. Lovable에 해결을 요청하고 점검을 다시 실행하세요.
프로젝트 설정
Lovable이 가격이 있는 상품이 최소 하나 존재하고 최신 변경 사항이 게시되었는지 확인합니다.
검증 (KYC/KYB)
Complete verification을 클릭하면 Paddle의 판매자 검증 폼이 열립니다. 이 폼은 제품 정보, 컴플라이언스 심사 질문, 개인 또는 사업자 정보를 수집합니다.
사업자 유형은 Individual(개인 사업자), Private company, Public company가 있습니다. Individual로 시작하는 것이 빠릅니다. 이후 Paddle 대시보드에서 업그레이드할 수 있습니다.
검증 처리 시간은 위치와 제품에 따라 다릅니다. 대부분 하루 내에 승인되지만 며칠이 걸릴 수도 있습니다. Paddle이 이메일이나 Paddle 대시보드를 통해 추가 신원 또는 사업자 서류를 요청할 수 있습니다.
대기 중에 다음을 할 수 있습니다.
- 검증 완료 전까지 프로덕션에서 체크아웃 버튼을 숨기도록 Lovable에 요청
- 프로젝트 게시를 대기
- 그대로 게시(승인 전까지 체크아웃이 동작하지 않음)
자세한 내용은 Paddle's account verification documentation을 참고하세요.
도메인 검토
Paddle이 라이브 도메인을 검토해 실제 콘텐츠와 법적 페이지가 있는 정당한 제품인지 확인합니다. 제출 전에 배포된 사이트가 완성되어 있는지 확인하세요.
승인
모든 단계가 통과되면 프로덕션 앱이 실제 결제를 받을 수 있습니다. Paddle 대시보드에서 은행 계좌 정보를 추가하도록 안내하는 Set up payouts 배너가 나타납니다.
Stripe로 라이브 전환
Stripe 라이브 전환 과정의 일부는 Lovable이 아니라 Stripe 대시보드에서 진행됩니다. Stripe 사이트에서 직접 단계를 완료해야 합니다.
Stripe 계정 소유권 확보
Payments 탭의 링크를 클릭해 Lovable이 만들어 준 Stripe 계정의 소유권을 확보합니다. Stripe는 이를 "sandbox" 계정이라고 부릅니다. Stripe의 claim 페이지가 열리며 소유권을 확보할 수 있습니다.
이미 Stripe 계정이 있다면 이 단계에서 sandbox를 기존 계정과 연결할 수 있습니다. 새 계정을 만들 필요가 없습니다.
Stripe에서 라이브 전환 단계 완료
Stripe 대시보드에서 온보딩 체크리스트를 완료하세요.
- Stripe 계정 설정
- 이메일 인증
- 계정 온보딩 완료
Stripe는 이 과정에서 테스트 계정의 상품, 가격, Lovable 앱을 라이브 계정으로 복사하도록 안내합니다. 이 과정에서 라이브 계정에 Lovable 앱이 설치되어 라이브 API 키와 웹훅이 연결됩니다.
준비 상태 점검
Lovable이 라이브 사이트를 검토해 다음을 확인합니다.
- 개인정보 처리방침 존재 여부
- 이용 약관 존재 여부
- 환불 정책 존재 여부
- 사이트 콘텐츠가 진정성 있고 충실한지
모든 단계가 완료되면 프로덕션 앱이 실제 결제를 받을 수 있습니다. 정산 구성은 Stripe 대시보드에서 직접 관리합니다.
게시 및 상품 동기화
프로젝트를 게시하면 Lovable을 통해 만든 상품과 가격이 Paddle과 Stripe 모두에서 라이브 환경으로 자동 동기화됩니다. 수동으로 재생성할 필요가 없습니다.
제공업체 대시보드에서 상품을 직접 편집하지 마세요. Lovable 내 컨텍스트 손실과 테스트/라이브 환경 간 ID 불일치가 발생할 수 있습니다. 상품은 항상 Lovable을 통해 관리하세요.
할인은 게시 동기화에 포함되지 않습니다. 테스트에서 할인 코드를 만들었다면 라이브 환경에서 별도로 만들어야 합니다.
제한 사항
- 기본적으로 디지털 제품: 실물 제품은 Shopify 연동 또는 Stripe로 구동되는 내장 결제를 사용하세요.
- 프로젝트당 결제 제공업체 하나: 같은 프로젝트에서 Paddle과 Stripe를 함께 사용할 수 없습니다.
- 기본적으로 환경별 사용자당 구독 하나: 각 사용자는 하나의 활성 구독을 가질 수 있습니다. 애드온이나 복수 구독이 필요하면 Lovable에 조정을 요청하세요.
- 결제가 있는 프로젝트는 리믹스 불가: 결제가 활성화된 프로젝트는 포크할 수 없습니다.
- 체크아웃 스타일 및 결제 수단: 이러한 설정은 Lovable이 아닌 제공업체 대시보드에서 구성해야 합니다.
- 웹훅을 수동으로 만들지 마세요: Lovable이 웹훅 엔드포인트를 자동 등록합니다. 중복이 생기면 문제가 발생할 수 있습니다.
모범 사례
- 검증 제출 전에 준비 상태 점검 실행: 문제를 일찍 해결하면 지연을 방지할 수 있습니다.
- 라이브 전환 전에 커스텀 도메인 사용: 제공업체가 라이브 도메인을 검토합니다. 커스텀 도메인이
.lovable.app보다 정당해 보입니다. - 프리뷰에서 전체 구독 수명 주기 테스트: 구매, 취소, 갱신, 결제 실패, 체험.
- 명확한 statement descriptor 선택: 고객이 은행 명세서에서 청구 내역을 알아볼 수 있어야 합니다.
- 구독이 취소되었다고 해서 즉시 접근 권한을 회수하지 마세요: 사용자는 현재 결제 주기 종료까지 이미 결제한 상태이므로 그때까지는 접근 권한을 유지해야 합니다.
- 갱신 실패를 우아하게 처리: 즉시 접근 권한을 회수하기보다 결제 수단을 업데이트하도록 유도하세요.
- 상품은 Lovable에서 관리: 제공업체 대시보드에서 수동 변경하면 환경 간 불일치가 발생할 수 있습니다.