Recurly

US 또는 EU 리전의 비공개 API 키로 Recurly를 연결합니다.

RevGlance는 Recurly API 버전 2021-02-25에서 결제된 청구 인보이스, 환불 거래, 구독을 읽습니다.

연결

Recurly에서 Integrations › API Credentials를 열고 비공개 API 키를 추가합니다. 이름은 RevGlance로 지정합니다.
키를 복사하고 사이트 서브도메인을 적어 둡니다. acme.recurly.com이라면 acme입니다.
키, 사이트가 호스팅된 리전(us 또는 eu), 서브도메인을 입력한 다음 Recurly 연결을 선택합니다.

리전에는 us 또는 eu를 입력합니다. EU에 호스팅된 사이트는 Recurly의 EU API를 사용합니다.

RevGlance에서 설정 › 소스를 열고 Recurly 소스의 메뉴를 연 다음 Webhook을 선택합니다. URL을 복사합니다.
Recurly에서 Integrations › Webhooks를 열고 그 URL로 JSON 형식의 엔드포인트를 추가합니다.
엔드포인트의 서명 시크릿을 복사해 RevGlance의 서명 시크릿에 붙여넣고 저장합니다.

RevGlance는 recurly-signature 헤더를 확인하고, 5분이 넘은 호출은 거부합니다.

결제된 청구 인보이스: 세전 금액.
성공한 환불 거래: 인보이스와 같은 비율로 세금을 뺍니다.
구독: MRR, 플랜, 체험판, 해지에 사용됩니다. Recurly는 API를 통해 해지 이유를 제공하지 않으며 게이트웨이 수수료도 보고하지 않습니다.

결제된 청구 인보이스는 세전으로 집계됩니다.
환불은 성공한 환불 거래입니다. 세금이 포함되어 있으므로 RevGlance가 인보이스와 같은 비율로 세금을 뺍니다.
Recurly는 게이트웨이 수수료를 보고하지 않으므로 수수료는 0으로 표시됩니다.
MRR은 Recurly의 구독 소계입니다(단가, 수량, 애드온, 쿠폰 적용 후, 세전).
해지된 구독은 만료될 때까지 계속 집계되며, 만료·실패·일시 중지된 구독은 이탈로 집계됩니다. Recurly는 API로 해지 사유를 제공하지 않습니다.
수금하지 못한 결제는 실패한 결제로 집계됩니다. 금액은 이동하지 않습니다.
지불 거절은 읽지 않으므로, 진 지불 거절은 결제 대행사가 환불로도 보고하지 않는 한 결제로 계속 집계됩니다.

회수는 고객을 Recurly 사이트의 호스팅된 계정 페이지로 연결합니다. 양식에서 서브도메인을 묻는 이유가 이것입니다.