RevGlanceDocumentation

Recurly

Connectez Recurly avec une clé API privée, dans la région US ou EU.

RevGlance lit la version 2021-02-25 de l’API Recurly : factures de paiement réglées, transactions de remboursement et abonnements.

Connexion

  1. Dans Recurly, ouvrez Integrations › API Credentials et ajoutez une clé API privée. Nommez-la RevGlance.
  2. Copiez la clé et notez le sous-domaine de votre site : acme pour acme.recurly.com.
  3. Saisissez la clé, la région où votre site est hébergé (us ou eu) et le sous-domaine, puis choisissez Connecter Recurly.

Ce que demande le formulaire

ChampRessemble à
Clé API privéeStocké chiffré0123456789abcdef0123456789abcdef
Régionus ou eu
Sous-domaine du siteacme (de acme.recurly.com)

Indiquez us ou eu comme région. Les sites hébergés dans l’UE utilisent l’API EU de Recurly.

Ajouter le webhook

  1. Dans RevGlance, ouvrez Paramètres › Sources, ouvrez le menu de la source Recurly et choisissez Webhook. Copiez l’URL.
  2. Dans Recurly, ouvrez Integrations › Webhooks et ajoutez un endpoint avec cette URL au format JSON.
  3. Copiez le secret de signature de l’endpoint, collez-le sous Secret de signature dans RevGlance et enregistrez.

RevGlance vérifie l’en-tête recurly-signature et refuse les appels de plus de cinq minutes.

Ce que RevGlance synchronise

  • Factures de paiement réglées, hors taxes.
  • Transactions de remboursement réussies, diminuées des taxes dans la même proportion que sur la facture.
  • Abonnements, pour le MRR, les plans, les essais et les annulations. Recurly ne fournit aucun motif d’annulation via son API et ne transmet aucune commission de passerelle.

Comment Recurly est calculé

  • Les factures de paiement réglées comptent hors taxes.
  • Les remboursements sont les transactions de remboursement réussies. Elles incluent la taxe : RevGlance la déduit donc dans la même proportion que sur la facture.
  • Recurly ne fournit aucune commission de passerelle : les commissions s’affichent donc à zéro.
  • Le MRR correspond au sous-total Recurly de l’abonnement (montant unitaire, quantité et options, après coupons, hors taxes).
  • Un abonnement annulé continue de compter jusqu’à son expiration ; les abonnements expirés, échoués et suspendus comptent dans l’attrition. Recurly ne fournit aucun motif de annulation via l’API.
  • Un paiement qui n’a pas pu être encaissé compte comme un paiement échoué. Il ne déplace aucun argent.
  • Les rétrofacturations ne sont pas lues : une rétrofacturation perdue reste donc comptée comme un paiement, sauf si le fournisseur la signale aussi comme remboursement.

E-mails de récupération

Récupérer envoie le client vers sa page de compte hébergée sur votre site Recurly : c’est pourquoi le formulaire demande le sous-domaine.