RevGlancePaddle
거래, 조정, 구독, 고객을 읽을 수 있는 API 키로 Paddle Billing을 연결합니다.
연결
- Paddle에서 Developer tools › Authentication을 열고 API 키를 만듭니다. Paddle Billing만 지원하며 Paddle Classic은 지원하지 않습니다.
- transactions, adjustments, subscriptions, customers를 읽을 수 있게 허용합니다. 회수 이메일을 보낼 계획이라면
transaction.write도 추가합니다. - 키를 복사합니다. 라이브 키는
pdl_live_apikey_로 시작합니다. 샌드박스 키도 사용할 수 있으며, 이 경우 Paddle 샌드박스에서 동기화합니다. - API 키에 붙여넣고 Paddle 연결을 선택합니다.
양식에서 묻는 항목
| 필드 | 형식 예시 |
|---|---|
| API 키암호화하여 저장 | pdl_live_apikey_… |
Webhook 추가하기
- RevGlance에서 설정 › 소스를 열고 Paddle 소스의 메뉴를 연 다음 Webhook을 선택합니다. URL을 복사합니다.
- Paddle에서 Developer tools › Notifications를 열고 그 URL로 대상을 추가합니다. 거래, 조정, 구독 이벤트를 선택합니다.
- 대상의 secret key를 복사해 RevGlance의 서명 시크릿에 붙여넣고 저장합니다.
RevGlance가 동기화하는 항목
- 결제되었거나 완료된 거래와 그 고객 및 주소.
- 조정: 승인된 환불과 지불 거절은 환불이 되며, 취소되면 다시 빠집니다.
- 구독: MRR, 플랜, 체험판, 해지에 사용되며, 반복 할인은 MRR에서 뺍니다.
- 활성 및 보관된 고객.
Paddle은 해지 이유를 보관하지 않으므로 해지는 이유 없이 들어옵니다.
Paddle의 집계 방식
- 금액은 Paddle 정산 합계에서 세전으로 가져오며, Paddle 수수료가 수수료입니다.
- 환불과 지불 거절은 세전으로 집계됩니다. Paddle이 이긴 지불 거절이나 Paddle이 취소한 환불은 더 이상 집계되지 않습니다.
- Paddle이 가져가는 지불 거절 수수료는 수수료로 집계됩니다.
- 세금 포함 가격은 다음 인보이스의 세금 비율에 따라 세전으로 MRR에 집계됩니다.
- 반복 할인은 나중에 보관 처리되었더라도 MRR에서 차감됩니다.
- 수금하지 못한 결제는 실패한 결제로 집계됩니다. 금액은 이동하지 않습니다.
회수 이메일
회수는 각 실패한 결제를 Paddle의 결제 수단 업데이트 체크아웃으로 연결합니다. 이를 위해서는 키에 transaction.write가 필요하며, 없으면 이메일은 자체 카드 업데이트 페이지로 연결됩니다.