RevGlanceDoku

Recurly

Verbinden Sie Recurly mit einem privaten API-Schlüssel, in der Region US oder EU.

RevGlance liest die Recurly-API in der Version 2021-02-25: bezahlte Zahlungsrechnungen, Rückerstattungstransaktionen und Abonnements.

Verbinden

  1. Öffnen Sie in Recurly Integrations › API Credentials und fügen Sie einen privaten API-Schlüssel hinzu. Nennen Sie ihn RevGlance.
  2. Kopieren Sie den Schlüssel und notieren Sie die Subdomain Ihrer Site: acme für acme.recurly.com.
  3. Tragen Sie den Schlüssel, die Region, in der Ihre Site gehostet wird (us oder eu), und die Subdomain ein und wählen Sie dann Recurly verbinden.

Was das Formular abfragt

FeldSieht so aus
Privater API-SchlüsselVerschlüsselt gespeichert0123456789abcdef0123456789abcdef
Regionus oder eu
Site-Subdomainacme (aus acme.recurly.com)

Geben Sie als Region us oder eu ein. In der EU gehostete Sites nutzen die EU-API von Recurly.

Den Webhook hinzufügen

  1. Öffnen Sie in RevGlance Einstellungen › Quellen, öffnen Sie das Menü der Recurly-Quelle und wählen Sie Webhook. Kopieren Sie die URL.
  2. Öffnen Sie in Recurly Integrations › Webhooks und fügen Sie einen Endpunkt mit dieser URL im JSON-Format hinzu.
  3. Kopieren Sie das Signing Secret des Endpunkts, fügen Sie es in RevGlance unter Signing Secret ein und speichern Sie.

RevGlance prüft den Header recurly-signature und lehnt Aufrufe ab, die älter als fünf Minuten sind.

Was RevGlance synchronisiert

  • Bezahlte Zahlungsrechnungen, vor Steuern.
  • Erfolgreiche Rückerstattungstransaktionen, mit abgezogener Steuer im selben Anteil wie auf der Rechnung.
  • Abonnements, für MRR, Pläne, Testphasen und Kündigungen. Recurly liefert über seine API keinen Kündigungsgrund und meldet keine Gateway-Gebühren.

Wie Recurly gezählt wird

  • Bezahlte Rechnungen zählen vor Steuern.
  • Rückerstattungen sind die erfolgreichen Erstattungstransaktionen. Sie enthalten Steuern, daher zieht RevGlance die Steuer im selben Anteil wie auf der Rechnung ab.
  • Recurly meldet keine Gateway-Gebühren, daher erscheinen Gebühren als null.
  • Der MRR ist die Zwischensumme von Recurly für das Abonnement (Stückpreis, Menge und Add-ons, nach Gutscheinen, vor Steuern).
  • Ein gekündigtes Abonnement zählt bis zu seinem Ablauf weiter; abgelaufene, fehlgeschlagene und pausierte zählen als Abwanderung. Recurly liefert über die API keinen Kündigungsgrund.
  • Eine Zahlung, die nicht eingezogen werden konnte, zählt als fehlgeschlagene Zahlung. Es fließt kein Geld.
  • Rückbuchungen werden nicht gelesen, daher bleibt eine verlorene als Zahlung gezählt, sofern der Anbieter sie nicht auch als Rückerstattung meldet.

Rückhol-E-Mails

Zurückholen verlinkt den Kunden auf seine gehostete Kontoseite auf Ihrer Recurly-Site; deshalb fragt das Formular nach der Subdomain.