Corriger une erreur « crédits insuffisants »

Crédit et solde épuisés, ou workflow avec un contrôle que le crédit Free ne peut pas payer ? Trouvez lequel et évitez que l'erreur se reproduise.

Si une demande de vérification échoue avec "You don't have enough credits to perform this request", ou si l'API répond avec le code d'erreur insufficient_credits lorsque vous créez une session, le solde de votre organisation ne peut pas couvrir une fonctionnalité que le workflow essaie d'exécuter. La même cause peut aussi se manifester par une erreur « crédits épuisés » (parfois un 502), par exemple quand le workflow inclut la vérification téléphonique ou la validation en base de données, que le crédit de l'offre Free ne paie pas.

#Vérifiez le workflow avant de vérifier le solde

Le réflexe est de regarder votre usage. Regardez d'abord votre workflow, car chaque module activé est payé avec vos 10 $ de crédit mensuel (offre Free), puis avec votre solde, et certains modules coûtent bien plus que les quatre de base (vérification d'identité, preuve de vie passive, face match 1:1 et analyse d'appareil et d'IP, soit 0,33 $ au total). Les coupables habituels, dans l'ordre où ils apparaissent réellement :

#Corriger le problème

1. Ouvrez le workflow utilisé par la session en échec

   Pas n'importe quel workflow : celui dont l'ID a servi à créer la session. Dans Workflows, vérifiez chaque fonctionnalité activée par rapport au tableau ci-dessus.

2. Cherchez l'interrupteur caché du style personnalisé

   White label est un réglage par workflow appelé Inclure un style personnalisé, et il ne figure pas dans la liste des étapes, c'est pourquoi un audit des étapes ne le trouve jamais. Dans l'éditeur de workflow, c'est le petit interrupteur à côté de l'icône de nuancier de couleurs dans l'en-tête, et il n'apparaît que lorsque vous survolez cette icône : un workflow peut donc porter une image de marque sans que personne ne se souvienne de l'avoir fait. Le même réglage se trouve aussi dans la barre latérale Paramètres du workflow, où il est toujours visible.

3. Vérifiez votre solde

   Paramètres → Facturation et forfait affiche votre solde actuel. Si le crédit de votre mois est épuisé et que le solde est nul ou négatif, tout le travail facturable s'arrête jusqu'à ce qu'il repasse au-dessus de zéro.

4. Retirez la fonctionnalité payante, ou rechargez

   Si vous n'avez pas besoin de la fonctionnalité payante, désactivez-la et republiez. Si vous en avez besoin, ajoutez des fonds : la recharge minimum est de 50 $. Voir recharges, factures et moyens de paiement.

#Autres causes à écarter

• Un solde négatif. Une fois le solde passé sous zéro et le crédit mensuel épuisé, les contrôles en production s'arrêtent. C'est le cas où l'erreur ne vient réellement pas d'un module en particulier.
• La clé de la mauvaise application. Le solde est par organisation, mais si vous appelez avec une clé pour une application dont le workflow diffère de celui que vous avez audité, vous regardez la mauvaise configuration. Voir organisations, applications et environnements.
• Un appel API autonome plutôt qu'une session de workflow. Les appels autonomes sont facturés à l'appel au prix public et utilisent le même crédit et le même solde, ils peuvent donc les épuiser plus vite que prévu.
• Vérification téléphonique ou validation en base de données avant toute recharge. Les deux restent inactives tant que votre organisation n'a pas fait une première vraie recharge ; le crédit de l'offre Free ne les débloque pas. Voir recharges, factures et moyens de paiement.
• Une sandbox qui fonctionnait et une application de production qui ne fonctionne pas. La sandbox ne facture jamais rien, elle ne peut donc pas révéler une fonctionnalité payante. La première session en production est celle où le vrai prix du workflow apparaît.
• Vous avez vraiment utilisé les 10 $ du mois. Vérifiez Analytics pour le volume du mois par fonctionnalité, et Utilisation pour ce que chaque contrôle a coûté, avant de supposer que c'est celle-ci. Le crédit se renouvelle le 1er.

#Empêcher que ça se reproduise

• Activez la recharge automatique dans Paramètres → Facturation et forfait pour que le solde se recharge automatiquement sous un seuil que vous choisissez.
• Testez en sandbox, où rien n'est facturé et où la vérification du solde est entièrement contournée. Voir tester en sandbox.
• Séparez vos applications de test et live, pour qu'une expérimentation ne puisse pas vider le solde dont dépend votre trafic de production.

#Plafonner votre dépense

Si vous voulez un plafond strict pour qu'un compte ne puisse pas devenir négatif pendant les tests, c'est un contrôle au niveau du compte plutôt qu'un réglage de workflow : demandez au support ce qui est disponible pour votre organisation. En attendant, la version pratique consiste à continuer de tester dans une application sandbox, où il n'y a rien à dépenser.

#Si les recharges ne sont pas en libre-service

Les organisations sur un plan annuel ne peuvent pas acheter de crédits via le flux de recharge en libre-service : contactez plutôt votre gestionnaire de compte. Une tentative en libre-service vous le dira au lieu d'échouer silencieusement.

#Si votre solde semble faux

Si votre solde, vos factures ou votre historique de vérification semblent soudainement manquants ou incorrects, c'est presque toujours un problème temporaire de la plateforme plutôt que des données perdues. Contactez le support plutôt que d'essayer de le réparer vous-même, et incluez l'ID de votre organisation.