Passer au contenu principal
Vous pouvez gérer l’intégralité de votre cycle de facturation via l’API ou la console. Ce guide explique comment lister les plans, estimer les coûts, créer une session de paiement, vérifier votre abonnement, ajouter des modules complémentaires et annuler si nécessaire.

Prérequis

  • Un compte Truthlocks avec un locataire actif.
  • Une clé API avec des permissions de facturation. Voir Clés API pour en créer une.

Choisir un plan

Truthlocks propose cinq niveaux de plan. Utilisez le point de terminaison des plans pour récupérer le catalogue complet — il s’agit d’un point de terminaison public qui ne nécessite pas d’authentification.
Voir aperçu de la facturation pour une comparaison de tous les plans.

Estimer vos coûts

Avant de vous abonner, utilisez le point de terminaison d’estimation pour obtenir une recommandation de plan basée sur votre utilisation prévue. Il s’agit également d’un point de terminaison public.
La réponse comprend un plan recommandé et un total mensuel estimé. Pour une ventilation des coûts par poste, utilisez plutôt le point de terminaison facture projetée.

Vérifiez vos tarifs actuels

Les tarifs effectifs par utilisation de votre locataire dépendent de votre grille tarifaire et de votre région. Récupérez-les avec :
La réponse inclut les tarifs de base et les ajustements de prix régionaux :
Si votre organisation a une carte tarifaire personnalisée attribuée par un administrateur de plateforme, ces tarifs apparaissent ici au lieu des valeurs par défaut.

S’abonner à un plan

Créez une session de paiement pour démarrer ou mettre à niveau votre abonnement. Le service de facturation sélectionne automatiquement le fournisseur de paiement approprié pour votre région.
1

Créer une session de paiement

Appelez le point de terminaison de paiement avec le plan que vous souhaitez et les URL de redirection :
La réponse contient un checkout_url hébergé par le fournisseur de paiement.
2

Rediriger vers la caisse

Envoyez l’utilisateur à checkout_url pour finaliser le paiement.
3

Confirmer l'abonnement

Après le paiement, vérifiez que l’abonnement est actif :
Vous pouvez éventuellement passer un paramètre provider (stripe, paystack, ou flutterwave) pour remplacer le routage automatique basé sur la région. Voir routage du fournisseur pour plus de détails.

Attacher des modules complémentaires

Les modules complémentaires étendent votre plan avec des capacités supplémentaires. Attachez-les via l’API :
Si l’add-on a un prix, la réponse inclut un checkout_url pour effectuer le paiement. Les add-ons gratuits s’activent immédiatement.
Les prix des modules complémentaires s’ajustent automatiquement en fonction du pays de facturation de votre organisation. Les locataires des régions à faible coût paient un tarif réduit — par exemple, le pack de conformité coûte 149,50 /moisauNigeria(multiplicateurde0,5x)aulieuduprixdebasede299/mois au Nigeria (multiplicateur de 0,5x) au lieu du prix de base de 299 . Consultez la tarification régionale des modules complémentaires pour le tableau complet des niveaux.
Pour supprimer un module complémentaire :
Voir gérer les modules complémentaires pour le catalogue complet des modules complémentaires et les détails de la réponse.

Surveiller l’utilisation

Suivez votre consommation du cycle de facturation actuel pour rester dans les limites de votre plan :
Pour vérifier si une opération spécifique est dans le quota avant de l’exécuter :

Ouvrir le portail de facturation

Redirigez les utilisateurs vers le portail libre-service de leur fournisseur de paiement pour mettre à jour les méthodes de paiement, consulter les factures ou gérer leur abonnement :
La réponse inclut une portal_url. Redirigez l’utilisateur vers cette URL. Les sessions du portail expirent rapidement, alors générez une nouvelle URL à chaque fois.

Annuler un abonnement

Pour annuler, appelez le point de terminaison d’annulation. L’annulation prend effet à la fin de la période de facturation en cours — vous conservez un accès complet jusqu’à cette date.
Une fois la période terminée, votre compte est rétrogradé au plan Développeur (gratuit). Pour vous réabonner, créez une nouvelle session de paiement.
Vous ne pouvez pas annuler une annulation via l’API. Pour reprendre votre abonnement, vous devez repasser par le processus de paiement.

Lié

Aperçu de la facturation

Planifiez les niveaux, les tarifs, les droits et les add-ons.

Routage du fournisseur

Comment les paiements sont acheminés par région.

Référence de l'API de facturation

Référence complète du point de terminaison de l’API de facturation.

Droits

Vérifiez vos fonctionnalités et quotas actifs.