RevGlanceDocumentation

Chargebee

Connectez Chargebee avec une clé API en lecture seule et une URL de webhook contenant un secret.

RevGlance lit l’API v2 de Chargebee : factures payées, avoirs et abonnements. Les sites sur Product Catalog 2.0 comme sur l’ancien catalogue fonctionnent.

Connexion

  1. Dans Chargebee, ouvrez Settings › Configure Chargebee › API Keys et ajoutez une clé read-only pour toutes les données de votre site.
  2. Copiez la clé (elle commence par live_) et notez le nom de votre site : acme pour acme.chargebee.com.
  3. Saisissez le site et la clé, puis choisissez Connecter Chargebee.

Ce que demande le formulaire

ChampRessemble à
Siteacme (de acme.chargebee.com)
Clé APIStocké chiffrélive_…

Ajouter le webhook

Chargebee ne signe pas ses webhooks : le secret voyage donc avec l’URL.

  1. Dans RevGlance, ouvrez Paramètres › Sources, ouvrez le menu de la source Chargebee et choisissez Webhook. Enregistrez un long secret aléatoire sous Secret de signature.
  2. Copiez l’URL du webhook et ajoutez ?token= suivi de votre secret à la fin.
  3. Dans Chargebee, ouvrez Settings › Configure Chargebee › Webhooks et ajoutez un webhook avec cette adresse. Au lieu de ?token=, vous pouvez activer l’authentification basique et utiliser le secret comme mot de passe.

Ce que RevGlance synchronise

  • Factures payées, hors taxes.
  • Avoirs remboursables, comptés comme remboursements, diminués des taxes dans la même proportion que l’avoir.
  • Abonnements, pour le MRR, les plans, les essais et les annulations, avec le code de motif d’annulation configuré dans Chargebee.

Chargebee ne transmet aucune commission de passerelle : les commissions apparaissent donc à zéro.

Comment Chargebee est calculé

  • Les factures réglées comptent hors taxes.
  • Les remboursements proviennent des avoirs remboursables, moins la taxe dans la même proportion que sur l’avoir.
  • Chargebee ne fournit aucune commission de passerelle : les commissions s’affichent donc à zéro.
  • Le MRR correspond aux articles de plan et d’option, moins les coupons sur l’ensemble de la facture qui continuent de s’appliquer. Les paiements ponctuels sont exclus.
  • Les abonnements non renouvelables continuent de compter jusqu’à la fin de leur durée. Les abonnements suspendus comptent dans l’attrition. Le code de motif de annulation configuré dans Chargebee s’affiche comme motif.
  • Un paiement qui n’a pas pu être encaissé compte comme un paiement échoué. Il ne déplace aucun argent.
  • Une rétrofacturation ne compte que lorsqu’un avoir remboursable l’enregistre.