Integration mit Braintree

Braintree-Affiliate-Software, Webhook-nativ für Abos.

Betreib ein Affiliate- oder Kunden-Empfehlungsprogramm auf Braintree, mit Provisions-Tracking, das dafür gebaut ist. Braintree (ein PayPal-Unternehmen) löst Webhooks für Abos und Streitfälle aus, und Rekomi hört nativ zu: Füge schreibgeschützte API-Zugangsdaten ein, richte einen Webhook auf deine eigene Rekomi-URL, und jede wiederkehrende Abbuchung mit rekomi_ref wird verifiziert und gutgeschrieben, Rückbuchungen holen die Provision automatisch zurück. Einmalverkäufe laufen über die S2S-API; diese Aufteilung ist eine Grenze von Braintree, und wir sagen das offen.

Braintree
nativ
Rekomi
Für Abo-Unternehmen mit wiederkehrender Abrechnung über Braintree, Einmalverkäufe über einen signierten API-Aufruf angebunden.
Jeder Plan · ab $29/Monat
So funktioniert es mit Braintree

Ein Custom Field, ein Webhook und schreibgeschützte Schlüssel.

01 / 03
Das Feld rekomi_ref anlegen

Lege im Braintree Control Panel ein Custom Field rekomi_ref mit der Store-and-pass-back-Option an. Dein Backend setzt die vom Rekomi-Head-Skript erfasste Empfehlung beim Verkauf auf jede Transaktion; über dieses Feld nennt der Verkauf seinen Affiliate.

02 / 03
Webhook richten, Schlüssel einfügen

Lege einen Braintree-Webhook auf deine eigene Rekomi-URL an, mit den Benachrichtigungsarten für Abos und Streitfälle, und füge dann Merchant ID, Public Key und Private Key eines eigenen schreibgeschützten Nutzers ein. Beim Verbinden geprüft, verschlüsselt gespeichert, nie wieder angezeigt.

03 / 03
Wiederkehrend erfasst, Streitfälle storniert

subscription_charged_successfully verbucht in jedem Zyklus die wiederkehrende Provision, dispute_lost holt sie anteilig zurück, und Kündigungen stoppen die Uhr. Einmalverkäufe schickt dein Backend über die HMAC-signierte S2S-API.

Ehrlich beim Umfang

Webhooks, wo Braintree sie hat. S2S, wo nicht.

Braintree sendet nur Webhooks für Abos und Streitfälle; für einen Einmalverkauf per Karte oder seine Erstattung gibt es kein Ereignis auf Seiten des Zahlungsanbieters. Tools, die etwas anderes behaupten, pollen oder raten. Rekomi teilt die Arbeit ehrlich auf: Der Weg für wiederkehrende Zahlungen und der Weg für Rückbuchungen laufen von allein über signierte Webhooks, und Einmalverkäufe kommen über einen einzigen signierten Server-zu-Server-Aufruf aus deinem Backend. Beide Wege landen im selben Provisionsbuch des Affiliates.

Zwei Wege, ein ProvisionsbuchSDK-geprüfte Signaturen
Weg 1 · Webhook-nativläuft von allein
subscription_charged_successfully+$29.00 wiederkehrend
dispute_lost-$29.00 zurückgeholt
Weg 2 · EinmalverkäufeS2S-API
POST /api/v1/sale · HMAC-signiert+$149.00 einmalig

Braintree löst für Einmalverkäufe per Karte keinen Webhook aus, also leitet dein Backend sie stattdessen in einer signierten Anfrage weiter. Gleiche Attribution, gleiches Buch.

Attributionsfeld
rekomi_ref · Custom Field
Zugangsdaten
schreibgeschützt · verschlüsselt
Signaturprüfung offline · kein RoundtripKleinste Einheiten je Währung
Was du bekommst

Gemacht für das echte Ereignismodell von Braintree.

Rückforderung bei Streitfällen

Ein verlorener Streitfall (dispute_lost) storniert die Provision anteilig, bevor sie je einen Auszahlungslauf erreicht. Andere Streitfall-Benachrichtigungen werden bestätigt, aber nur ein verlorener Streitfall ändert das Provisionsbuch.

Schreibgeschützt, mit Absicht

Rekomi fragt nach den Schlüsseln eines eigenen schreibgeschützten Braintree-Nutzers, mehr nicht. Webhook-Signaturen werden offline über das offizielle Braintree-SDK geprüft, und die Schlüssel liegen verschlüsselt gespeichert.

Der ganze Lebenszyklus abgedeckt

Abo-Ereignisse für Abbuchung, Kündigung und Ablauf steuern das Buch, die wiederkehrende Umsatzbeteiligung stoppt also genau dann, wenn der Umsatz stoppt; die Benachrichtigungsarten für überfällige und fehlgeschlagene Abbuchungen sind der Vollständigkeit halber abonniert.

Der Nebenweg über Server-zu-Server

Einmalverkäufe gehen mit derselben rekomi_ref-Empfehlung an die signierte Server-zu-Server-API. Wiederholungen sind sicher, nichts zählt doppelt, die Provision sieht im Buch also identisch aus.

Auszahlungen unverändert

Abrechnung auf Braintree, Auszahlung über Rekomi: Affiliates richten sich über Stripe Express ein, KYC übernimmt Stripe, Auszahlungsläufe werden für dich erledigt, und die Steuerunterlagen werden zum Jahresende abgewickelt.

Teil eines größeren Stacks

Stripe, Paddle und mehr sind neben Braintree ebenfalls nativ, und jeder andere Zahlungsanbieter kann Verkäufe über dieselbe Server-zu-Server-API den richtigen Affiliates gutschreiben. Dein Programm überlebt jede einzelne Entscheidung für einen Zahlungsdienstleister.

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 Braintree.

Erfasst die native Braintree-Integration Einmalverkäufe?

Nicht über Webhooks, denn Braintree löst keinen Webhook für Einmalverkäufe per Karte aus; das ist eine Grenze von Braintree, nicht von Rekomi. Abos und Streitfälle sind komplett Webhook-nativ und laufen von allein. Einmalverkäufe werden über die signierte Server-zu-Server-API von Rekomi erfasst: Dein Backend schickt den Verkauf per POST mit der Empfehlung, und die Provision wird genau wie bei einem per Webhook gelieferten Verkauf verbucht.

Auf welche Braintree-Ereignisse hört Rekomi?

Auf den Abo-Lebenszyklus (subscription_charged_successfully, subscription_canceled, subscription_expired, subscription_went_past_due, subscription_charged_unsuccessfully) und die Streitfall-Ereignisse (dispute_opened, dispute_lost, dispute_won, dispute_accepted). Die Check-Benachrichtigung von Braintree bei der Einrichtung wird automatisch bestätigt.

Welche Zugangsdaten braucht Rekomi, und wie werden sie gespeichert?

Merchant ID, Public Key und Private Key eines eigenen schreibgeschützten Braintree-Nutzers; Lesezugriff ist alles, was Rekomi braucht. Die Schlüssel werden beim Verbinden bei Braintree geprüft, verschlüsselt gespeichert und nie wieder angezeigt. Webhook-Signaturen werden offline über das offizielle Braintree-SDK geprüft, Ereignisse sind also ohne Roundtrip authentifiziert.

Wie wirken sich Rückbuchungen auf Provisionen aus?

Automatisch. Liefert Braintree dispute_lost, storniert Rekomi die Provision anteilig und aktualisiert das ausstehende Guthaben des Affiliates, du zahlst also nie auf eine Abbuchung aus, die die Bank zurückgeholt hat. Nur ein verlorener Streitfall ändert das Buch; andere Streitfall-Benachrichtigungen werden bestätigt, aber nicht verbucht.

Und freiwillige Erstattungen von Einmalverkäufen?

Braintree sendet keinen Webhook für Erstattungen von Einmalverkäufen per Karte, es gibt also nichts, worauf Rekomi hören könnte; du weist die Provision des Affiliates manuell im Conversion-Datensatz in Rekomi ab, ein Klick. Abo-Kündigungen und abgelaufene Abos werden automatisch erfasst.

Wie wird der Affiliate an einen Braintree-Verkauf gehängt?

Über ein Custom Field rekomi_ref, einmal im Braintree Control Panel mit der Store-and-pass-back-Option angelegt. Dein Backend setzt die Empfehlung (clientseitig vom Rekomi-Head-Skript erfasst) beim Verkauf auf die Transaktion; Rekomi liest sie aus der Abbuchungs-Transaktion, die mit dem Abo-Webhook ankommt. Das Feld liegt auf der Transaktion, nicht auf dem Abo, weil Braintree-Abos nur begrenzte Metadaten haben.

Kann Braintree neben Stripe oder Paddle in einem Workspace laufen?

Nein. Rekomi erlaubt pro Workspace nur eine Conversion-Quelle, gleich ob Stripe, Paddle, Braintree oder die Server-zu-Server-API, damit derselbe Verkauf nie doppelt verbucht wird. Trenne zuerst die andere, oder führe einen zweiten Workspace, wenn du wirklich auf zwei Plattformen abrechnest.

Bereit, wenn du es bist

Zehn Minuten bis zum ersten Klick.

Richte einen Braintree-Webhook auf Rekomi, füge schreibgeschützte Schlüssel ein, und wiederkehrende Provisionen verbuchen sich von selbst. 14 Tage kostenlos testen.

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