RevGlanceDoku

Braintree

Verbinden Sie Braintree mit einem API-Schlüsselpaar, um Transaktionen und wiederkehrende Abrechnung zu lesen.

RevGlance liest die Gateway-API von Braintree, die auch die Server-SDKs von Braintree nutzen, denn nur dort liegt die wiederkehrende Abrechnung.

Verbinden

  1. Öffnen Sie im Braintree Control Panel Settings › API und erstellen Sie ein neues API-Schlüsselpaar.
  2. Kopieren Sie Merchant ID, Public key und Private key. Der API-Benutzer, zu dem sie gehören, braucht eine Rolle, die Transaktionen und Abonnements lesen darf.
  3. Tragen Sie sie ein, geben Sie unter Umgebung production ein (oder sandbox für ein Sandbox-Konto) und wählen Sie Braintree verbinden.

Was das Formular abfragt

FeldSieht so aus
Händler-IDabc123def456ghi7
Öffentlicher Schlüssel7xh9k3b2m4n5p6q8
Privater SchlüsselVerschlüsselt gespeichert0123456789abcdef0123456789abcdef
Umgebungproduction oder sandbox

Den Webhook hinzufügen

Braintree signiert seine Webhooks mit denselben API-Schlüsseln, die die Quelle bereits hat, daher gibt es kein Secret einzufügen.

  1. Öffnen Sie in RevGlance Einstellungen › Quellen, öffnen Sie das Menü der Braintree-Quelle und wählen Sie Webhook. Kopieren Sie die URL.
  2. Öffnen Sie im Braintree Control Panel Settings › Webhooks, erstellen Sie einen Webhook mit dieser URL und wählen Sie die Abo- und Transaktionsbenachrichtigungen aus.

Was RevGlance synchronisiert

  • Transaktionen: abgerechnete und in Abrechnung befindliche Verkäufe werden zu Zahlungen; Gutschriften werden zu Rückerstattungen. Autorisierungen, die nie eingezogen wurden, bleiben außen vor.
  • Abonnements mit ihren Plänen, Add-ons und Rabatten, für MRR, Testphasen und Kündigungen.

Die erste Synchronisierung liest jede Transaktion, die Braintree aufbewahrt. Braintree meldet über seine API weder Bearbeitungsgebühren noch Kündigungsgründe.

Wie Braintree gezählt wird

  • Abgerechnete und in Abrechnung befindliche Verkäufe zählen, vor Steuern, wenn Sie Steuerbeträge übermitteln. Nie erfasste Autorisierungen zählen nicht.
  • Rückerstattungen sind die Gutschriftstransaktionen, datiert auf den Tag, an dem Braintree sie ausgeführt hat.
  • Braintree meldet über seine API keine Bearbeitungsgebühren, daher erscheinen Gebühren als null.
  • Der MRR ist der Abonnementpreis inklusive Add-ons, abzüglich Rabatten mit verbleibenden Abrechnungszyklen. Ein Abonnement nennt keinen Kunden, daher übernimmt es den Kunden seiner Zahlungen; eines ohne bisherige Zahlung erscheint unter seiner Karte.
  • Eine Kündigung wird anhand des Statusverlaufs datiert. Ein abgelaufenes Abonnement endet an seinem Bezahlt-bis-Datum.
  • 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.