RevGlanceChargebee
읽기 전용 API 키와 시크릿이 담긴 Webhook URL로 Chargebee를 연결합니다.
RevGlance는 Chargebee의 API v2에서 결제된 인보이스, 크레딧 노트, 구독을 읽습니다. Product Catalog 2.0을 쓰는 사이트와 이전 카탈로그를 쓰는 사이트 모두 지원합니다.
연결
- Chargebee에서 Settings › Configure Chargebee › API Keys를 열고 사이트의 모든 데이터에 대한 read-only 키를 추가합니다.
- 키(
live_로 시작)를 복사하고 사이트 이름을 적어 둡니다.acme.chargebee.com이라면acme입니다. - 사이트와 키를 입력한 다음 Chargebee 연결을 선택합니다.
양식에서 묻는 항목
| 필드 | 형식 예시 |
|---|---|
| 사이트 | acme(acme.chargebee.com에서) |
| API 키암호화하여 저장 | live_… |
Webhook 추가하기
Chargebee는 Webhook에 서명하지 않으므로 시크릿을 URL에 담아 보냅니다.
- RevGlance에서 설정 › 소스를 열고 Chargebee 소스의 메뉴를 연 다음 Webhook을 선택합니다. 길고 임의적인 시크릿을 서명 시크릿에 저장합니다.
- Webhook URL을 복사하고 끝에
?token=과 시크릿을 붙입니다. - Chargebee에서 Settings › Configure Chargebee › Webhooks를 열고 그 주소로 Webhook을 추가합니다.
?token=대신 기본 인증을 켜고 시크릿을 비밀번호로 사용할 수도 있습니다.
RevGlance가 동기화하는 항목
- 결제된 인보이스: 세전 금액.
- 환불 가능한 크레딧 노트: 환불로 처리하며, 크레딧 노트와 같은 비율로 세금을 뺍니다.
- 구독: MRR, 플랜, 체험판, 해지에 사용되며, Chargebee에서 설정한 해지 이유 코드도 함께 가져옵니다.
Chargebee는 게이트웨이 수수료를 보고하지 않으므로 수수료는 0으로 표시됩니다.
Chargebee의 집계 방식
- 결제된 인보이스는 세전으로 집계됩니다.
- 환불은 환불 가능한 크레딧 노트에서 가져오며, 크레딧 노트와 같은 비율로 세금을 뺍니다.
- Chargebee는 게이트웨이 수수료를 보고하지 않으므로 수수료는 0으로 표시됩니다.
- MRR은 플랜과 애드온 항목에서 인보이스 전체에 계속 적용되는 쿠폰을 뺀 금액입니다. 일회성 청구는 제외됩니다.
- 갱신하지 않는 구독은 기간이 끝날 때까지 계속 집계됩니다. 일시 중지된 구독은 이탈로 집계됩니다. Chargebee에서 설정한 해지 사유 코드가 사유로 표시됩니다.
- 수금하지 못한 결제는 실패한 결제로 집계됩니다. 금액은 이동하지 않습니다.
- 지불 거절은 환불 가능한 크레딧 노트에 기록된 경우에만 집계됩니다.