RevGlanceDokumentacja

Recurly

Połącz Recurly prywatnym kluczem API, w regionie US lub EU.

RevGlance odczytuje API Recurly w wersji 2021-02-25: opłacone faktury za płatności, transakcje zwrotów i subskrypcje.

Połączenie

  1. W Recurly otwórz Integrations › API Credentials i dodaj prywatny klucz API. Nazwij go RevGlance.
  2. Skopiuj klucz i zanotuj subdomenę witryny: acme dla acme.recurly.com.
  3. Wypełnij klucz, region, w którym hostowana jest witryna (us lub eu), i subdomenę, a potem wybierz Połącz Recurly.

O co pyta formularz

PoleWygląda tak
Prywatny klucz APIPrzechowywane w postaci zaszyfrowanej0123456789abcdef0123456789abcdef
Regionus lub eu
Subdomena witrynyacme (z acme.recurly.com)

Wpisz us lub eu jako region. Witryny hostowane w UE używają API Recurly dla UE.

Dodawanie webhooka

  1. W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Recurly i wybierz Webhook. Skopiuj adres URL.
  2. W Recurly otwórz Integrations › Webhooks i dodaj punkt końcowy z tym adresem URL w formacie JSON.
  3. Skopiuj sekret podpisywania punktu końcowego, wklej go w polu Sekret podpisywania w RevGlance i zapisz.

RevGlance sprawdza nagłówek recurly-signature i odrzuca wywołania starsze niż pięć minut.

Co synchronizuje RevGlance

  • Opłacone faktury za płatności, przed podatkiem.
  • Udane transakcje zwrotów, z podatkiem odjętym w tej samej proporcji co na fakturze.
  • Subskrypcje, na potrzeby MRR, planów, okresów próbnych i anulowań. Recurly nie podaje przez swoje API powodu anulowania ani prowizji bramki.

Jak liczony jest Recurly

  • Opłacone faktury za płatności liczą się przed podatkiem.
  • Zwroty to udane transakcje zwrotu. Zawierają podatek, więc RevGlance odejmuje podatek w tej samej proporcji co na fakturze.
  • Recurly nie podaje prowizji bramki, więc prowizje są pokazywane jako zero.
  • MRR to suma częściowa Recurly dla subskrypcji (kwota jednostkowa, ilość i dodatki, po kuponach, przed podatkiem).
  • Anulowana subskrypcja liczy się do momentu wygaśnięcia; wygasłe, nieudane i wstrzymane liczą się jako odpływ. Recurly nie podaje powodu anulowania przez API.
  • 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.

E-maile odzyskiwania

Odzyskaj kieruje klienta na hostowaną stronę jego konta w twojej witrynie Recurly, dlatego formularz pyta o subdomenę.