RevGlanceDocumentatie

Recurly

Koppel Recurly met een private API-sleutel, in de regio VS of EU.

RevGlance leest versie 2021-02-25 van de API van Recurly: betaalde facturen voor betalingen, terugbetalingstransacties en abonnementen.

Koppelen

  1. Open in Recurly Integrations › API Credentials en voeg een private API-sleutel toe. Noem hem RevGlance.
  2. Kopieer de sleutel en noteer het subdomein van je site: acme voor acme.recurly.com.
  3. Vul de sleutel, de regio waar je site gehost wordt (us of eu) en het subdomein in, en kies dan Recurly koppelen.

Wat het formulier vraagt

VeldZiet eruit als
Privé-API-sleutelVersleuteld opgeslagen0123456789abcdef0123456789abcdef
Regious of eu
Subdomein van siteacme (van acme.recurly.com)

Vul us of eu in als regio. Sites die in de EU worden gehost, gebruiken de EU-API van Recurly.

Voeg de webhook toe

  1. Open in RevGlance Instellingen › Bronnen, open het menu van de Recurly-bron en kies Webhook. Kopieer de URL.
  2. Open in Recurly Integrations › Webhooks en voeg een endpoint toe met die URL in JSON-formaat.
  3. Kopieer het ondertekeningsgeheim van het endpoint, plak het onder Ondertekeningsgeheim in RevGlance en sla op.

RevGlance controleert de header recurly-signature en weigert aanroepen die ouder zijn dan vijf minuten.

Wat RevGlance synchroniseert

  • Betaalde facturen voor betalingen, exclusief btw.
  • Geslaagde terugbetalingstransacties, met btw eraf in dezelfde verhouding als op de factuur.
  • Abonnementen, voor MRR, proefperiodes en opzeggingen. Recurly geeft via zijn API geen opzegreden en meldt geen gatewaykosten.

Hoe Recurly wordt geteld

  • Betaalde facturen voor betalingen tellen vóór belasting.
  • Terugbetalingen zijn de geslaagde terugbetalingstransacties. Ze bevatten belasting, dus RevGlance haalt de belasting eraf in dezelfde verhouding als op de factuur.
  • Recurly meldt geen gatewaykosten, dus kosten worden als nul getoond.
  • De MRR is het subtotaal van Recurly voor het abonnement (bedrag per eenheid, aantal en add-ons, na kortingscodes, vóór belasting).
  • Een opgezegd abonnement blijft meetellen tot het verloopt; verlopen, mislukte en gepauzeerde abonnementen tellen als verloop. Recurly geeft via de API geen opzegreden.
  • 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.

Terugwin-e-mails

Terugwinnen linkt de klant naar diens gehoste accountpagina op je Recurly-site; daarom vraagt het formulier om het subdomein.