Auf Braintree installieren

Verbinde dein Braintree-Konto direkt mit Rekomi, richte einen Braintree-Webhook auf Rekomi ein und füge deine API-Zugangsdaten ein. Wiederkehrende Verkäufe und Rückbuchungen werden dann automatisch erfasst, ganz ohne Relay im Backend.

Braintree (ein Unternehmen von PayPal) ist ein Zahlungsanbieter. Rekomi ist für Abonnements direkt mit Braintree integriert: Du richtest ein Webhook-Ziel in Braintree auf Rekomi ein und fügst API-Zugangsdaten mit reinem Lesezugriff ein, und jede wiederkehrende Abbuchung wird automatisch geprüft und erfasst, ohne dass du ein Relay im Backend bauen musst. Du bist noch am Abwägen? Lies Warum Rekomi für Braintree →.

Ein offenes Wort zum Umfang: Braintree sendet Webhooks nur für Abonnements und Streitfälle, nicht für einmalige Kartenzahlungen oder Kartenerstattungen (das ist eine Grenze von Braintree, nicht von Rekomi). Dieser direkte Weg erfasst also wiederkehrende Umsätze und holt bei Rückbuchungen automatisch zurück. Für einmalige Verkäufe nutzt du die Server-to-Server-API; bei einmaligen Kartenerstattungen lehnst du die Provision von Hand ab.

Die Attribution hat zwei Hälften: Das Rekomi-Skript erfasst den Affiliate-Klick auf deinen Marketing-Seiten, und du gibst diese Empfehlung in einem benutzerdefinierten Feld an Braintree weiter. Wenn Braintree die Abbuchung an Rekomi sendet, wird die Empfehlung auf der Transaktion dem Affiliate zugeordnet.

Kein wiederkehrender Braintree-Plan? Nutze stattdessen die Server-to-Server-API. Dieser Weg übermittelt Conversions aus deinem eigenen Backend, für jeden Checkout.

1. Das Head-Skript installieren

Füge das Rekomi-Head-Skript in den <head> deiner Marketing-Website ein, auf jeder Seite, die zu einem Kauf führen kann, damit der Klick erfasst wird, bevor der Käufer den Checkout erreicht.

<script async src="https://api.rekomi.com/api/v1/r/loader.js" data-program-id="YOUR_PROGRAM_ID" data-rkmi-email-capture="auto"></script>

Auf einem No-Code-Baukasten (Webflow, Framer, Squarespace usw.) nutzt du das Feld der Plattform für eigenen Head-Code. Deine Programm-ID findest du im Dashboard unter Einstellungen, Tracking, Website-Snippet (der Installationsbereich).

Rekomi erfasst eine E-Mail-Adresse, die ein vermittelter Besucher auf den Seiten, auf denen das Tag läuft, in ein beliebiges E-Mail- oder Textfeld tippt (Registrierung, Login, Checkout und andere Formulare), damit der Verkauf auch dann gutgeschrieben werden kann, wenn dein Checkout keine Empfehlung übergibt. Ohne Empfehlung wird nichts erfasst. Entferne das Attribut data-rkmi-email-capture, um das auszuschalten; explizite Aufrufe von Rekomi.convert() funktionieren weiterhin.

2. Das benutzerdefinierte Feld für die Empfehlung anlegen

Gehe im Braintree Control Panel zu Settings → Processing → Custom Fields und lege ein benutzerdefiniertes Feld mit dem API-Namen rekomi_ref an, eingestellt auf Store and pass back. Dieses Feld trägt den Link-Slug des Affiliates auf jeden Verkauf.

Wenn dein Backend dann die erste Transaktion für den Verkauf anlegt, schreib die beim Checkout erfasste Empfehlung in das benutzerdefinierte Feld dieser Transaktion:

// the referral is the affiliate's link slug, captured client-side at checkout
const rekomiRef = window.Rekomi && window.Rekomi.getReferral();

// pass it to your backend, then set it on the transaction:
//   customFields: { rekomi_ref: rekomiRef }

Das benutzerdefinierte Feld muss genau rekomi_ref heißen. Rekomi liest es aus der Transaktion, die Braintree mit dem Abonnement-Webhook liefert.

Abgleich über die Lead-E-Mail (Fallback). Erreicht eine Abo-Abbuchung Rekomi ohne rekomi_ref auf der Transaktion und enthält die Transaktion die E-Mail-Adresse des Käufers, gleicht Rekomi diese Adresse zusätzlich mit den Leads ab, die das Rekomi-Skript in den letzten 90 Tagen auf deiner eigenen Website erfasst hat (schalte die E-Mail-Erfassung in deinem Registrierungsformular mit data-rkmi-email-capture="auto" am Loader-Tag ein; siehe Lead-Tracking), und schreibt dem Affiliate gut, der diesen Lead gebracht hat. Ist das benutzerdefinierte Feld vorhanden, hat es immer Vorrang, genauso wie der bisherige Verlauf des Kunden bei späteren Abbuchungen, und ein Affiliate, der mit seiner eigenen E-Mail-Adresse kauft, bekommt keine Gutschrift.

3. Deine Rekomi-Webhook-URL holen

Öffne in Rekomi Einrichtung, wähle Zahlungsanbieter verbinden und klicke auf Braintree verbinden. Rekomi zeigt eine Webhook-URL, die nur für deinen Workspace gilt, zum Beispiel:

Die Seite Braintree verbinden in Rekomi mit der Webhook-URL deines Workspaces und den Feldern für die Zugangsdaten

https://api.rekomi.com/api/webhooks/braintree/<your-token>

Kopiere sie. Diese URL gehört nur dir, und an ihr erkennt Rekomi, zu welchem Workspace ein Ereignis gehört. Halte sie geheim.

4. Das Braintree-Webhook-Ziel anlegen

Gehe in Braintree zu Settings → Webhooks → Create new webhook und füge die Rekomi-Webhook-URL ein. Wähle diese Benachrichtigungsarten:

subscription_charged_successfully
subscription_canceled
subscription_expired
subscription_went_past_due
subscription_charged_unsuccessfully
dispute_opened
dispute_lost
dispute_won
dispute_accepted

Speichere den Webhook. Braintree sendet möglicherweise eine check-Benachrichtigung, um die URL zu prüfen; Rekomi bestätigt sie automatisch.

5. Deine API-Zugangsdaten in Rekomi einfügen

Lege in Braintree einen eigenen Nutzer mit reinem Lesezugriff an (Account, Users) und erzeuge die API-Schlüssel dieses Nutzers. Lesezugriff ist alles, was Rekomi braucht; achte darauf, dass der Nutzer Pläne sehen darf, denn die liest Rekomi, um die Schlüssel zu prüfen. Füge zurück auf der Seite Braintree verbinden die Merchant ID, den Public Key und den Private Key ein, wähle deine Umgebung (Produktion oder Sandbox) und klicke auf Braintree verbinden.

Deine Schlüssel werden beim Verbinden gegen Braintree geprüft, verschlüsselt gespeichert und nie wieder angezeigt. Ab jetzt wird jede wiederkehrende Abbuchung mit rekomi_ref automatisch dem richtigen Affiliate gutgeschrieben.

Erstattungen und Streitfälle

Rückbuchungen laufen automatisch: Sendet Braintree ein Ereignis dispute_lost, macht Rekomi die Provision anteilig rückgängig und aktualisiert das ausstehende Guthaben des Affiliates.

Freiwillige Erstattungen einmaliger Kartenzahlungen erzeugen keinen Braintree-Webhook (eine Grenze von Braintree). Dafür lehnst du die Provision des Affiliates von Hand in der Conversion ab. Abwanderung bei wiederkehrenden Abonnements (Kündigung / Ablauf) wird automatisch erfasst.

Gut zu wissen

Die Empfehlung hängt an der Transaktion, nicht am Abonnement. Braintree-Abonnements haben nur wenige Metadaten, deshalb muss das benutzerdefinierte Feld rekomi_ref beim Verkauf auf der Transaktion gesetzt werden. Rekomi liest es aus der Abbuchungstransaktion, die mit dem Abonnement-Webhook kommt, und wiederkehrende Kunden werden bei späteren Abbuchungen über ihren Verlauf zugeordnet.

Einmalige Verkäufe laufen über S2S. Braintree sendet für einmalige Kartenzahlungen keinen Webhook, erfasse sie also über die Server-to-Server-API.

Eine Conversion-Quelle pro Workspace. Braintree Connect schließt Stripe (über die Rekomi-App für Stripe), Paddle, Shopify, Lemon Squeezy, Chargebee, Polar, Recurly, Gumroad, Creem, Dodo Payments, Mollie und die S2S-API aus, damit derselbe Verkauf nie doppelt gezählt wird. Trenne die eine Verbindung, bevor du eine andere herstellst.

Fehlerbehebung

Eine Braintree-Abo-Abbuchung ist nicht in Rekomi aufgetaucht. Prüfe vier Dinge: Das Webhook-Ziel enthält subscription_charged_successfully, das benutzerdefinierte Feld rekomi_ref der Abbuchungstransaktion enthält den Slug des Affiliates, das benutzerdefinierte Feld steht in deinem Control Panel auf „Store and pass back“, und der Affiliate ist freigegeben. Das Webhook-Protokoll von Braintree zeigt für jedes Ereignis die Zustellung und den Antwortcode von Rekomi.

Der Webhook liefert 401. Die gespeicherten API-Zugangsdaten fehlen, sind falsch oder wurden ausgetauscht, deshalb kann das Braintree-SDK die Webhook-Signatur nicht gegen deine Schlüssel prüfen. Kopiere Merchant ID und Schlüssel deines Nutzers mit Lesezugriff erneut und verbinde neu. (Ein 404 bedeutet dagegen, dass der Token in der Webhook-URL veraltet ist; verbinde neu, um die aktuelle URL zu bekommen.)

Die Verbindung wird in Rekomi als unterbrochen angezeigt. Die API-Schlüssel wurden ausgetauscht, oder der Nutzer mit Lesezugriff wurde entfernt. Lege den Nutzer neu an oder kopiere die Schlüssel in Braintree erneut und verbinde dann auf der Seite Braintree verbinden neu.

Auf Braintree installieren

On this page