구독 결제·수익 관리 플랫폼인 Chargebee에 앱을 연결해 고객, 구독, 청구서, 결제 워크플로우를 관리합니다.
Chargebee에 앱 연결하기
구독 결제·수익 관리 플랫폼인 Chargebee에 앱을 연결해 고객, 구독, 청구서, checkout, 결제 워크플로우를 관리하세요.
Chargebee는 고객, 구독, 청구서, 결제, 제품 카탈로그, hosted checkout, 결제 포털 흐름을 관리하는 구독 결제·수익 관리 플랫폼입니다. Chargebee connector를 사용하면 Lovable 앱이 workspace 수준의 연결을 통해 Chargebee API를 호출할 수 있습니다.
Chargebee를 연결하면 앱은 다음 작업이 가능합니다.
- 고객과 구독 목록 조회 및 관리
- 청구서, 크레딧 노트, 결제, 주문 읽기
- 제품·항목 가격을 기반으로 결제 워크플로우 구축
- Hosted checkout 페이지와 결제 포털 흐름 생성
Chargebee connector는 앱에 구독 결제 데이터, 고객 결제 워크플로우, 또는 Chargebee 계정 기반의 내부 도구가 필요할 때 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 고객 결제 포털 | Chargebee를 사용해 고객이 구독, 청구서, 결제 상태를 볼 수 있는 결제 포털을 만들어줘. | Chargebee의 결제 정보에 고객이 직접 접근합니다. 앱이 Chargebee에서 고객, 구독, 청구서, 결제 데이터를 읽어 셀프 서비스 포털로 제공합니다. |
| 구독 관리 대시보드 | Chargebee를 사용해 고객을 검색하고 구독과 청구서 상태를 확인하는 어드민 대시보드를 만들어줘. | 운영팀이 구독 계정을 한 곳에서 관리합니다. 앱이 Chargebee 고객과 구독을 나열해 고객지원·재무 팀이 계정 상태를 파악할 수 있게 합니다. |
| Checkout 흐름 | Chargebee를 사용해 구독 플랜의 hosted checkout 페이지를 생성하는 checkout 흐름을 만들어줘. | 앱에서 구독 checkout을 시작합니다. 앱이 Chargebee hosted checkout 페이지를 생성하고 고객을 구독 가입 완료 페이지로 리다이렉트합니다. |
| 매출 보고 앱 | Chargebee를 사용해 최근 청구서, 결제, 크레딧 노트, 주문을 보여주는 매출 대시보드를 만들어줘. | 결제 활동을 운영 보고서로 전환합니다. 앱이 Chargebee 결제 기록을 읽고 팀을 위해 최근 매출 활동을 요약합니다. |
| 플랜 관리 도구 | Chargebee를 사용해 제품, 항목 가격, 구독 플랜 상세 정보를 검토하는 내부 도구를 만들어줘. | Chargebee의 제품 카탈로그 데이터를 표면에 드러냅니다. 앱이 Chargebee 제품과 가격 데이터를 읽어 팀이 앱을 벗어나지 않고 플랜을 확인할 수 있게 합니다. |
| 갱신 워크플로우 트래커 | Chargebee를 사용해 다가오는 구독 갱신과 결제 실패를 추적하는 워크플로우 트래커를 만들어줘. | 후속 조치가 필요한 결제 이벤트를 추적합니다. 앱이 Chargebee 구독·결제 데이터를 사용해 주의가 필요한 계정을 강조 표시합니다. |
Chargebee 연결하기
Workspace admins와 owners가 Chargebee를 연결할 수 있습니다.
다른 API 키를 사용해 여러 Chargebee 연결을 생성할 수 있습니다. 환경을 분리하거나(예: 테스트·프로덕션) 다른 Chargebee 사이트를 연결할 때 유용합니다.
연결이 생성되면 workspace 내 모든 프로젝트에서 Chargebee를 사용할 수 있습니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해달라고 요청할 수 있습니다.
사전 준비
Chargebee를 연결하기 전에 다음을 준비하세요.
- Chargebee 계정
- Chargebee 사이트 이름, 예:
https://acme-test.chargebee.com에서acme-test - Chargebee API 키
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 API 요청은 Chargebee 계정을 사용합니다. API 사용량, 제한, 결제는 Lovable이 아닌 Chargebee가 직접 처리합니다.
Step 1: Chargebee 사이트 이름 및 API 키 가져오기
Chargebee API 키로 Lovable 앱이 연결된 사이트의 Chargebee API에 인증합니다. 환경이나 앱별로 별도 키를 생성할 수 있습니다.
사이트 이름을 확인하고 Chargebee API 키를 생성하려면 다음 단계를 따르세요.
Chargebee 사이트 열기
연결할 사이트의 계정으로 Chargebee에 로그인합니다.
사이트 이름 확인하기
Chargebee URL에서 사이트 이름을 복사합니다. 예를 들어 URL이 https://acme-test.chargebee.com이면 Lovable에 acme-test를 입력합니다.
API 키 열기
Chargebee의 API 키 안내에 따라 사이트의 API 키 영역을 엽니다.
API 키 생성 또는 복사하기
Lovable용 키를 생성하거나 앱에 필요한 Chargebee API 작업 권한이 있는 기존 키를 복사합니다. 예를 들어 Lovable integration처럼 알아보기 쉬운 이름을 사용하세요.
키 복사하기
API 키를 복사하고 안전하게 보관합니다.
API 키는 비밀번호처럼 기능합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Chargebee 문서를 참고하세요. Chargebee API getting started.
Step 2: Chargebee를 Lovable에 연결하기
다른 API 키를 사용해 여러 연결을 생성할 수 있습니다.
Connectors에서 Chargebee 열기
Connectors → App connectors로 이동해 Chargebee를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 예를 들어
Chargebee Prod또는Chargebee Test처럼 연결 이름을 지정합니다. - Site name:
.chargebee.com없이 Chargebee 사이트 이름을 입력합니다. 예:acme-test. - API key: Chargebee API 키를 붙여넣습니다.
이 연결에 접근할 수 있는 사람 선택하기
Who can access this connection 아래에서 workspace 내 누가 이 연결을 사용할 수 있는지 결정합니다.
- Only you (기본): 연결을 생성한 사람만 사용할 수 있습니다.
- Invite specific people: 명시적으로 추가된 workspace 멤버만 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable workspace 전체에 공개합니다.
자세한 내용은 Connection-level access를 참고하세요.
연결하기
Connect를 클릭합니다.
연결이 완료되면 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 Chargebee에 연결해달라고 요청할 수 있습니다(구성된 connection-level access 기준). Lovable 앱은 Chargebee를 통해 고객, 구독, 청구서, checkout, 결제 워크플로우를 관리할 수 있습니다.
제한사항
Chargebee connector는 다음 작업을 지원하지 않습니다.
- Chargebee 계정 또는 사이트 구성 생성·관리
- connector를 통해 Chargebee 웹훅 직접 수신
- API 키 자동 교체. 키를 교체하려면 Chargebee에서 새 키를 생성하고 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Chargebee 로그인. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 Chargebee 계정을 나타냅니다.
- Chargebee API 권한, 제한, 결제 규칙 우회
Chargebee 연결에서 프로젝트 연결 해제하기
Editors 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **Chargebee**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택하기
Linked projects 아래에서 연결을 해제할 프로젝트를 체크합니다.
확인하기
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 Chargebee에 접근할 수 없습니다. 다시 Chargebee가 필요하면 사용 가능한 연결에 프로젝트를 연결하면 됩니다.
Chargebee 연결 삭제하기
Workspace admins와 owners가 Chargebee 연결을 삭제할 수 있습니다. 다른 멤버는 본인이 생성했거나 명시적으로 접근 권한을 부여받은 연결만 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되고, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용하는 프로젝트를 확인하세요.
연결을 삭제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **Chargebee**를 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토하기
Linked projects 섹션을 검토합니다.
삭제하기
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.