RevGlance문서

Lemon Squeezy

API 키와 서명된 Webhook으로 Lemon Squeezy를 연결합니다.

RevGlance는 API 키로 Lemon Squeezy 스토어의 상품, 고객, 주문, 구독, 구독 인보이스를 읽습니다.

연결

  1. Lemon Squeezy에서 Settings › API를 열고 새 API 키를 만듭니다. 이름은 RevGlance로 지정합니다.
  2. 키를 바로 복사합니다. Lemon Squeezy는 키를 한 번만 보여 줍니다.
  3. API 키에 붙여넣고 Lemon Squeezy 연결을 선택합니다. RevGlance는 상품, 고객, 주문, 구독과 그 인보이스를 읽습니다.

양식에서 묻는 항목

필드형식 예시
API 키암호화하여 저장eyJ0eXAiOiJKV1Qi…

Webhook 추가하기

  1. RevGlance에서 설정 › 소스를 열고 Lemon Squeezy 소스의 메뉴를 연 다음 Webhook을 선택합니다. URL을 복사합니다.
  2. Lemon Squeezy에서 Settings › Webhooks를 열고 그 URL로 Webhook을 추가합니다. 길고 임의적인 signing secret을 만들고 주문, 구독, 구독 결제 이벤트를 선택합니다.
  3. 같은 시크릿을 RevGlance의 서명 시크릿에 붙여넣고 저장합니다.

RevGlance가 동기화하는 항목

  • Variants: 구독과 일회성 상품을 구분하고 각 플랜의 주기를 읽습니다.
  • 구독: 매번 전체를 읽으며 MRR, 플랜, 체험판, 해지에 사용됩니다.
  • 고객, 주문, 구독 인보이스. Lemon Squeezy는 날짜 필터 없이 최신순으로 나열하므로, 이후 동기화는 마지막 동기화보다 60일 전까지 거슬러 읽고, 오래된 주문의 환불을 잡아내기 위해 일주일에 한 번은 전부 다시 읽습니다.

Lemon Squeezy의 집계 방식

  • 결제는 주문 또는 인보이스 합계에서 세금을 뺀 금액입니다.
  • Lemon Squeezy는 세금 포함 환불을 보고하므로 RevGlance가 비율에 따라 세금을 뺍니다. 가끔 1센트의 반올림 차이가 있을 수 있습니다.
  • 전액 환불은 Lemon Squeezy가 처리한 날짜로 기록됩니다. 부분 환불은 날짜가 없어 인보이스 날짜에 표시됩니다.
  • 해지된 구독은 결제된 기간이 끝날 때까지 계속 집계됩니다. 미결제 구독(재시도 4회 실패)은 이탈로 집계되며, 결제가 회복되면 다시 돌아옵니다.
  • Lemon Squeezy는 해지 날짜나 사유를 보내지 않습니다. 해지 날짜는 구독이 마지막으로 변경된 날입니다.
  • Lemon Squeezy는 수수료를 보고하지 않으므로 수수료는 0으로 표시됩니다.
  • 할인은 갱신에 표시되면 MRR에서 차감됩니다. Lemon Squeezy는 할인의 반복 여부를 알려 주지 않으므로, 첫 인보이스에만 있는 할인은 집계되지 않습니다.
  • 오래된 주문의 환불은 주 1회 전체 읽기로 잡아내므로 최대 일주일 늦게 표시될 수 있습니다.
  • 연결 전에 전환된 체험판은 표시되지 않습니다. Lemon Squeezy는 체험판이 진행 중일 때만 알려 줍니다.
  • 지불 거절은 읽지 않으므로, 진 지불 거절은 결제 대행사가 환불로도 보고하지 않는 한 결제로 계속 집계됩니다.