Braintree

Koppel Braintree met een API-sleutelpaar om transacties en terugkerende facturering te lezen.

RevGlance leest de gateway-API van Braintree, dezelfde die de server-SDK's van Braintree gebruiken, omdat terugkerende facturering alleen daar te vinden is.

Koppelen

Open in het Braintree Control Panel Settings › API en genereer een nieuw API-sleutelpaar.
Kopieer de Merchant ID, Public key en Private key. De API-gebruiker waar ze bij horen, heeft een rol nodig die transacties en abonnementen kan lezen.
Vul ze in, voer onder Omgeving production in (of sandbox voor een sandboxaccount) en kies Braintree koppelen.

Wat het formulier vraagt

Veld	Ziet eruit als
Merchant-ID	`abc123def456ghi7`
Openbare sleutel	`7xh9k3b2m4n5p6q8`
PrivésleutelVersleuteld opgeslagen	`0123456789abcdef0123456789abcdef`
Omgeving	`production of sandbox`

Voeg de webhook toe

Braintree ondertekent zijn webhooks met dezelfde API-sleutels die de bron al heeft, dus er hoeft geen geheim geplakt te worden.

Open in RevGlance Instellingen › Bronnen, open het menu van de Braintree-bron en kies Webhook. Kopieer de URL.
Open in het Braintree Control Panel Settings › Webhooks, maak een webhook aan met die URL en selecteer de meldingen voor abonnementen en transacties.

Wat RevGlance synchroniseert

Transacties: afgehandelde en lopende verkopen worden betalingen; credits worden terugbetalingen. Autorisaties die nooit zijn geïnd, blijven buiten beschouwing.
Abonnementen met hun abonnementsvorm, add-ons en kortingen, voor MRR, proefperiodes en opzeggingen.

De eerste synchronisatie leest elke transactie die Braintree bewaart. Braintree geeft via zijn API geen verwerkingskosten en geen opzegredenen door.

Hoe Braintree wordt geteld

Verrekende verkopen en verkopen in verrekening tellen, vóór belasting als je belastingbedragen meestuurt. Autorisaties die nooit zijn geïnd tellen niet.
Terugbetalingen zijn de credittransacties, met de datum waarop Braintree ze uitvoerde.
Braintree meldt geen verwerkingskosten via de API, dus kosten worden als nul getoond.
De MRR is de abonnementsprijs met add-ons, min kortingen die nog factureringscycli over hebben. Een abonnement noemt geen klant, dus het krijgt de klant van zijn betalingen; een abonnement zonder betaling verschijnt onder zijn kaart.
Een opzegging krijgt de datum uit de statusgeschiedenis. Een verlopen abonnement eindigt op de datum tot waar het is betaald.
Een betaling die niet kon worden geïnd, telt als mislukte betaling. Er wordt geen geld verplaatst.
Chargebacks worden niet gelezen, dus een verloren chargeback blijft als betaling meetellen, tenzij de provider die ook als terugbetaling meldt.