RevGlanceDokumentacja

Braintree

Połącz Braintree parą kluczy API, aby odczytywać transakcje i płatności cykliczne.

RevGlance odczytuje API bramki Braintree, to samo, którego używają serwerowe SDK Braintree, bo płatności cykliczne są dostępne tylko tam.

Połączenie

  1. W Braintree Control Panel otwórz Settings › API i wygeneruj nową parę kluczy API.
  2. Skopiuj Merchant ID, Klucz publiczny i Klucz prywatny. Użytkownik API, do którego należą, potrzebuje roli, która może odczytywać transakcje i subskrypcje.
  3. Wypełnij je, wpisz production (lub sandbox dla konta sandbox) w polu Środowisko i wybierz Połącz Braintree.

O co pyta formularz

PoleWygląda tak
Merchant IDabc123def456ghi7
Klucz publiczny7xh9k3b2m4n5p6q8
Klucz prywatnyPrzechowywane w postaci zaszyfrowanej0123456789abcdef0123456789abcdef
Środowiskoproduction lub sandbox

Dodawanie webhooka

Braintree podpisuje swoje webhooki tymi samymi kluczami API, które źródło już ma, więc nie trzeba wklejać sekretu.

  1. W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Braintree i wybierz Webhook. Skopiuj adres URL.
  2. W Braintree Control Panel otwórz Settings › Webhooks, utwórz webhook z tym adresem URL i wybierz powiadomienia o subskrypcjach i transakcjach.

Co synchronizuje RevGlance

  • Transakcje: rozliczone i rozliczane sprzedaże stają się płatnościami; uznania stają się zwrotami. Autoryzacje, które nigdy nie zostały pobrane, są pomijane.
  • Subskrypcje z ich planami, dodatkami i rabatami, na potrzeby MRR, okresów próbnych i anulowań.

Pierwsza synchronizacja odczytuje każdą transakcję przechowywaną przez Braintree. Braintree nie podaje przez swoje API prowizji za obsługę płatności ani powodów anulowania.

Jak liczony jest Braintree

  • Sprzedaż rozliczona i w trakcie rozliczania liczy się przed podatkiem, jeśli przesyłasz kwoty podatku. Autoryzacje, które nigdy nie zostały pobrane, się nie liczą.
  • Zwroty to transakcje uznaniowe, z datą ich wykonania przez Braintree.
  • Braintree nie podaje prowizji za przetwarzanie przez swoje API, więc prowizje są pokazywane jako zero.
  • MRR to cena subskrypcji z dodatkami, minus rabaty, którym zostały jeszcze cykle rozliczeniowe. Subskrypcja nie wskazuje klienta, więc przejmuje klienta ze swoich płatności; taka, która nie ma jeszcze płatności, jest pokazywana pod swoją kartą.
  • Data anulowania pochodzi z historii statusów. Wygasła subskrypcja kończy się w dniu, do którego jest opłacona.
  • Płatność, której nie udało się pobrać, liczy się jako nieudana płatność. Nie przenosi pieniędzy.
  • Obciążenia zwrotne nie są odczytywane, więc przegrane nadal liczy się jako płatność, chyba że dostawca zgłosi je też jako zwrot.