Integration mit Recurly

Recurly-Affiliate-Software, unabhängig vom Zahlungsanbieter und mit annullierten Zahlungen im Blick.

Recurly ist Abo-Abrechnung, die auf dem Zahlungsanbieter aufsetzt, den du schon nutzt, und Rekomi bindet es nativ an: Wähle deine Datenregion (USA oder EU), füge einen schreibgeschützten privaten API-Schlüssel ein und lege in Recurly einen XML-Webhook mit den Basic-Authentication-Zugangsdaten an, die Rekomi erzeugt. Ab dann werden bezahlte Rechnungen, Abo-Verlängerungen, Erstattungen und annullierte Zahlungen (Voids) dem richtigen Affiliate automatisch gutgeschrieben und wieder abgezogen, ohne Relay-Code, den du schreiben oder pflegen musst.

Recurly
nativ
Rekomi
Für SaaS- und Abo-Unternehmen, die ihr Affiliate- oder Empfehlungsprogramm auf Recurly-Abrechnung betreiben.
Jeder Plan · ab $29/Monat
So funktioniert es mit Recurly

Region verbinden, Empfehlung mitgeben, Rechnungen fließen lassen.

01 / 03
Deine Recurly-Site verbinden

Wähle deine Datenregion (USA oder EU) und füge einen schreibgeschützten privaten API-Schlüssel ein; Rekomi prüft ihn live in deiner Region, und ein Schlüssel aus der anderen Region bekommt einen Regionsvorschlag statt eines kryptischen Fehlers. Lege dann in Recurly einen Webhook-Endpunkt mit der URL und den Basic-Authentication-Zugangsdaten an, die Rekomi für dich erzeugt: XML-Format, abonniert auf die Rechnungs-, Zahlungs-, Erstattungs- und Abo-Benachrichtigungen, die Rekomi nutzt.

02 / 03
rekomi_ref an Abos hängen

Recurly hostet den Checkout, die Empfehlung reist also auf dem Abo mit. Installiere das Head-Skript, lege ein benutzerdefiniertes Feld rekomi_ref auf dem Subscription-Objekt an (optional auch auf Account als Fallback) und setze es aus window.Rekomi.getReferral(), wenn dein Backend das Abo oder den Kauf anlegt. Benutzerdefinierte Felder brauchen Recurly Pro oder Elite; die FAQ spricht den Starter-Plan ehrlich an.

03 / 03
Rechnungen, Verlängerungen, Erstattungen, annullierte Zahlungen

Die erste bezahlte Rechnung verbucht die Conversion, und jede Verlängerung kommt als weitere bezahlte Rechnung und bringt wiederkehrende Provision, aus der Kundenhistorie zugeordnet, ganz ohne zusätzliche API-Aufrufe. Bei Erstattungen wird die Provision anteilig pro Erstattungstransaktion zurückgeholt, und annullierte Zahlungen werden komplett rückgängig gemacht, alles im selben Audit-Log.

Sicherheit, offen gesagt

Das Geld reist in XML, also authentifiziert Rekomi XML.

Recurly signiert seine JSON-Webhooks, aber nicht die XML-Webhooks, und nur die XML-Payloads tragen die vollständigen Gelddaten, die ehrliche Antwort darauf ist also, das technisch zu lösen, statt es zu beschönigen. Rekomi erzeugt Basic-Authentication-Zugangsdaten und authentifiziert jede Zustellung, bevor irgendetwas verarbeitet wird; die URL pro Workspace ist nicht zu erraten, und Zustellungen werden dedupliziert, damit die mehrtägige Wiederholungsleiter von Recurly nie einen Verkauf doppelt zählt. Der schreibgeschützte API-Schlüssel wird laufend geprüft, und weil Recurly-Schlüssel nie ablaufen, bedeutet eine fehlgeschlagene Prüfung immer etwas Echtes: Du bekommst eine E-Mail, sobald die Verbindung Aufmerksamkeit braucht.

Nur-Lese-VerbindungBasic-Auth geprüft
Rekomi erzeugt
Webhook-URL + Zugangsdaten
einmal angezeigt, verschlüsselt gespeichert
du legst in Recurly an
einen Endpunkt · XML-Format
Kennt die Region USA oder EU
paid_charge_invoice+$79.00 wiederkehrend · Verlängerung
successful_refund-$31.60 · anteilige Rückforderung
void_payment-$79.00 · komplett storniert
Schlüssel laufen nie ab. Wir prüfen trotzdem.
Recurly-API-Schlüssel haben kein Ablaufdatum; wird der Schlüssel jemals gelöscht oder widerrufen, mailt dir der Gesundheitscheck, bevor das Tracking leise stirbt.
Ein API-Lesezugriff pro erster ZahlungWiederholungen dedupliziert
Was du bekommst

Recurly-Affiliate-Tracking, das zur Art passt, wie Recurly wirklich abrechnet.

Unabhängig vom Zahlungsanbieter, mit Absicht

Recurly sitzt auf dem Zahlungsanbieter, den du schon betreibst (Stripe, Adyen, Braintree, GoCardless und mehr), und Rekomi hört auf Recurly, die maßgebliche Abrechnungsquelle, nicht auf den Anbieter darunter. Welcher Anbieter auch immer die Karte abwickelt, dieselben Webhooks melden die Zahlung, und an deinem Zahlungs-Routing ändert sich nichts.

Ehrlich abgesicherte Webhooks

Recurly signiert nur JSON-Webhooks, und das Geld steckt in den unsignierten XML-Webhooks, also steht das hier. Rekomi erzeugt Basic-Authentication-Zugangsdaten, authentifiziert jede Zustellung vor der Verarbeitung und speichert die Zugangsdaten und deinen schreibgeschützten Schlüssel verschlüsselt.

Verlängerungen auf Autopilot

Jede Verlängerung kommt als bezahlte Rechnung an und verbucht eine wiederkehrende Conversion, aus deiner Kundenhistorie zugeordnet, ganz ohne API-Aufrufe, die Umsatzbeteiligung läuft also über die gesamte Kundenbeziehung weiter, ohne weitere Arbeit.

Erstattungen und annullierte Zahlungen holen die Provision zurück

Erstattungen stornieren die Provision anteilig, pro Erstattungstransaktion, bis der ursprüngliche Betrag aufgebraucht ist; eine annullierte Zahlung macht den vollen Betrag rückgängig. Rückbuchungen über das Chargeback Management von Recurly kommen als erstattungsähnliche Ereignisse an und holen die Provision genauso zurück.

Ein Schlüssel, der wenig darf

Der API-Schlüssel ist schreibgeschützt und wird sparsam genutzt: die Prüfung beim Verbinden, regelmäßige Gesundheitschecks und ein begrenzter Lesezugriff bei der ersten Zahlung jedes Abos, um die Empfehlung zu holen. Verlängerungen rühren die API nie an, und Recurly-Schlüssel laufen nie ab, eine fehlgeschlagene Prüfung bedeutet also immer etwas Echtes.

Teil eines größeren Stacks

Stripe, Paddle, Braintree, Chargebee und mehr sind neben Recurly ebenfalls nativ, und bei jedem anderen Abrechnungssystem läuft die Zuordnung über die sichere S2S-API.

Alle Integrationen
Preise

Feste Pläne plus 3% der Auszahlungen. Kein Anteil an deinem Umsatz.

14 Tage kostenlose Testphase in jedem Plan · 3% der Affiliate-Auszahlungen, Auszahlungen laufen über Rekomi, Steuerformulare werden eingeholt · Alle Preise

FAQ

Häufige Fragen zu Recurly.

Ist die Recurly-Integration nativ?

Ja. Du wählst deine Datenregion (USA oder EU), fügst einen schreibgeschützten privaten API-Schlüssel ein und legst dann in Recurly einen Webhook-Endpunkt mit der URL und den Basic-Authentication-Zugangsdaten an, die Rekomi für dich erzeugt, im XML-Format. Bezahlte Rechnungen, Abo-Verlängerungen, Anmeldungen, Erstattungen und annullierte Zahlungen werden alle automatisch verbucht, ohne Relay-Code, den du schreiben oder pflegen musst. Rekomi prüft außerdem die Verbindung und mailt dir, falls der Schlüssel jemals nicht mehr gültig ist.

Mit welchen Zahlungsanbietern funktioniert es?

Mit allen, denn Rekomi hört auf Recurly, nicht auf den Zahlungsanbieter. Recurly sitzt auf dem Zahlungsanbieter, den du schon betreibst (Stripe, Adyen, Braintree, GoCardless und die anderen), und seine Webhooks melden jede Zahlung auf dieselbe Weise, egal welcher Anbieter die Karte abgewickelt hat. Du behältst deine Anbieter-Einrichtung genau so, wie sie ist; an deinem Zahlungs-Routing ändert sich nichts.

Wie sind die Webhooks abgesichert, wenn Recurly XML nicht signiert?

Offen gesagt: Die Signaturprüfung von Recurly gilt nur für JSON-Webhooks, und JSON-Payloads sind schlanke Kennungen; die XML-Payloads, die das Geld wirklich tragen, sind unsigniert, und Rekomi tut nicht so, als wäre es anders. Rekomi erzeugt Basic-Authentication-Zugangsdaten für den Endpunkt, und jede Zustellung wird damit authentifiziert, bevor irgendetwas verarbeitet wird; Zustellungen, die die Prüfung nicht bestehen, werden abgewiesen. Die Zugangsdaten und dein schreibgeschützter API-Schlüssel werden verschlüsselt gespeichert und nie von der API zurückgegeben, die URL pro Workspace ist nicht zu erraten, und alles läuft über HTTPS.

Welche Affiliate-Plattformen haben echte Recurly-Integrationen?

Die glaubwürdige Liste ist kurz. FirstPromoter und impact.com sind die einzigen etablierten Plattformen mit echten serverseitigen Recurly-Integrationen, und die von impact.com ist in der Beta; die meisten anderen begnügen sich mit Skripten auf der Danke-Seite oder Zapier-Relays, die Verlängerungen und Erstattungen verpassen. Rewardful hat gar keine Recurly-Anbindung; seine Integrationen sind Stripe und Paddle. Wenn deine Suche nach Recurly-Integrationen bei Affiliate-Plattformen immer wieder ins Leere lief, ist das die Lücke, die Rekomi schließt: eine moderne native Recurly-Integration neben Stripe, Paddle, Braintree, Chargebee und mehr, mit wiederkehrenden Provisionen, Rückforderungen bei Erstattungen und Auszahlungen über Rekomi.

Wie werden Affiliates gutgeschrieben, wenn Recurly den Checkout hostet?

Die Empfehlung reist auf dem Abo mit. Das Rekomi-Head-Skript speichert den Affiliate-Klick in einem First-Party-Cookie; du legst in Recurly ein benutzerdefiniertes Feld rekomi_ref auf dem Subscription-Objekt an (optional ein zweites auf Account als Fallback) und setzt es aus window.Rekomi.getReferral(), wenn dein Backend das Abo oder den Kauf anlegt. Bei der ersten Zahlung liest Rekomi das Feld mit deinem schreibgeschützten Schlüssel aus und verbucht die Conversion; Verlängerungen werden aus der Kundenhistorie zugeordnet, ohne weitere Arbeit.

Ich bin im Starter-Plan von Recurly. Funktioniert die Attribution?

Teilweise, und diese Seite tut nicht so, als wäre es anders. Benutzerdefinierte Felder sind bei Recurly an den Plan gebunden: Pro erlaubt bis zu 5, Elite bis zu 10, und im Starter-Plan gibt es sie gar nicht, es gibt also kein Feld, auf dem die Empfehlung mitreisen kann, und die Attribution neuer Kunden ist im Starter-Plan nicht verfügbar. Verlängerungen von Kunden, die Rekomi schon zugeordnet hat, werden in jedem Plan weiter erfasst, weil Verlängerungen aus der Kundenhistorie zugeordnet werden, nicht aus benutzerdefinierten Feldern.

Werden Verlängerungen, Erstattungen, annullierte Zahlungen und Rückbuchungen verarbeitet?

Ja, mit einem offen benannten Sonderfall. Jede Verlängerung kommt als bezahlte Rechnung an und verbucht eine wiederkehrende Conversion, die Umsatzbeteiligung läuft also über die gesamte Laufzeit des Abos weiter. Erstattungen holen die Provision anteilig zurück, pro Erstattungstransaktion, und eine annullierte Zahlung macht den vollen Transaktionsbetrag rückgängig. Der Sonderfall sind Rückbuchungen: Recurly hat keine Streitfall-Webhooks, Kartenstreitfälle erreichen Rekomi also nur, wenn deine Site das Chargeback Management von Recurly im Early Access nutzt, wo sie als erstattungsähnliche Ereignisse ankommen und wie Erstattungen zurückgeholt werden; Streitfälle, die direkt bei deinem Zahlungsanbieter geklärt werden, sieht Recurly nicht, und die passt du manuell an.

Was macht Rekomi mit dem API-Schlüssel?

So wenig wie möglich, und nie einen Schreibzugriff. Der Schlüssel wird in Recurly schreibgeschützt erstellt, und Rekomi nutzt ihn für genau drei Dinge: die Prüfung beim Einfügen, regelmäßige Gesundheitschecks und einen begrenzten Lesezugriff bei der ersten Zahlung jedes Abos, um das benutzerdefinierte Feld rekomi_ref zu holen. Verlängerungen lösen nie einen API-Aufruf aus; sie werden aus deiner Kundenhistorie zugeordnet. Der Schlüssel wird verschlüsselt gespeichert, nie von der API zurückgegeben und beim Trennen gelöscht.

Kann ich Recurly neben einer anderen Abrechnungs-Verbindung laufen lassen?

Nein; Rekomi erlaubt pro Workspace nur eine Conversion-Quelle, damit derselbe Verkauf nie doppelt verbucht wird. Wähle eine Verbindung für deine Recurly-Verkäufe und bleib dabei; verkaufst du wirklich auf zwei Plattformen, führe sie als getrennte Workspaces.

Bereit, wenn du es bist

Zehn Minuten bis zum ersten Klick.

Wähle deine Region, füge einen schreibgeschützten Schlüssel ein, lege in Recurly einen Webhook an, und bezahlte Rechnungen schreiben Affiliates noch heute Provisionen gut. 14 Tage kostenlos testen.

  • 14 Tage kostenlose Testphase
  • Jederzeit kündbar, $0 berechnet