Corriger une erreur « crédits insuffisants »
Presque toujours causée par une fonctionnalité payante dans un workflow que vous pensiez gratuit - white label, AML, NFC ou preuve de vie active. Voici comment trouver laquelle, et comment éviter que ça se reproduise.
Neuf fois sur dix, ce n'est pas une allocation gratuite épuisée. C'est une fonctionnalité payante dans le workflow - le plus souvent white label (0,20 $), l'AML (0,20 $), le NFC (0,15 $), ou la preuve de vie active (0,15 $). Ouvrez le workflow et regardez ce qui est activé avant de recharger.
Si une demande de vérification échoue avec "You don't have enough credits to perform this request", le solde de votre organisation ne peut pas couvrir une fonctionnalité que le workflow essaie d'exécuter.
L'API signale la même condition par le code d'erreur insufficient_credits à la création d'une session. Deux précisions qui évitent des tickets : dans le workflow, les méthodes de liveness actives s'appellent Flash 3D et Action 3D et Flash, et seul Liveness passif est gratuit ; et la validation en base de données ainsi que la vérification téléphonique nécessitent en plus une première recharge avant de s'exécuter (les 10 $ de bienvenue ne comptent pas). Voir validation en base de données.
#Vérifiez le workflow avant de vérifier le solde
Le réflexe est de regarder votre usage. Regardez d'abord votre workflow, car le forfait gratuit ne couvre que ces quatre fonctionnalités, chacune avec ses propres 500 contrôles gratuits par mois :
- Vérification d'identité
- Preuve de vie passive
- Face match 1:1
- Analyse d'appareil et d'IP
Chaque autre module est facturé dès le premier contrôle, quel que soit le volume. Les coupables habituels, dans l'ordre où ils apparaissent réellement :
| Fonctionnalité | Prix | Pourquoi ça surprend |
|---|---|---|
| White label / image de marque personnalisée | 0,20 $ par vérification | C'est un réglage d'apparence, ça ne ressemble donc pas à un « contrôle » |
| Cribage AML | 0,20 $ | Souvent ajouté à un modèle « KYC gratuit » sans y prêter attention |
| NFC | 0,15 $ | Facturé séparément de la vérification d'identité |
| Preuve de vie active | 0,15 $ | Passer de passive à active sort du forfait gratuit |
| Estimation d'âge | 0,10 $ | La vérification d'identité du forfait gratuit ne la couvre pas |
| Questionnaire | 0,10 $ | Ça ressemble à un formulaire, pas à un contrôle |
| Vérification téléphonique | à partir de 0,03 $ + frais opérateur | Les frais opérateur varient selon la destination |
| Vérification email | 0,03 $ | |
| Justificatif de domicile | 0,20 $ | |
| Validation de base de données | Varie selon le pays | |
| Vérification d'entreprise (KYB) | 2,00 $ |
White label est la cause la plus fréquente. Un workflow avec l'image de marque personnalisée activée coûte 0,20 $ par vérification terminée, en plus des prix par module, donc un flux que vous aviez conçu comme du KYC gratuit devient un flux payant dès que vous le marquez. Voir personnaliser l'image de marque.
#Corriger le problème
- 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.
- Vérifiez aussi l'onglet Options
White label est activé par workflow sous Settings → Options → Include custom style, pas dans la liste des étapes, donc c'est facile à manquer en auditant les étapes.
- Vérifiez votre solde
Settings → Billing affiche votre solde actuel. S'il est négatif, tout le travail facturable s'arrête, y compris vos contrôles du forfait gratuit, jusqu'à ce qu'il repasse au-dessus de zéro.
- 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.
- Ajouter du crédit efface l'erreur immédiatement.
- Confirmez qu'une recharge est bien arrivée avant de supposer que le solde est faux.
#Autres causes à écarter
-
Un solde négatif. Une fois le solde passé sous zéro, les contrôles du forfait gratuit s'arrêtent aussi. C'est le cas où l'erreur ne vient réellement pas d'une fonctionnalité payante.
-
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 avec aucune allocation gratuite, même pour les fonctionnalités gratuites au sein d'un workflow.
-
Vous avez vraiment utilisé les 500 d'une fonctionnalité. Vérifiez Analytics pour le volume du mois par fonctionnalité avant de supposer que c'est celle-ci, et rappelez-vous que chacune des quatre a sa propre allocation, donc c'est l'explication la moins probable à faible volume.
-
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 ; les crédits de bienvenue ne les débloquent 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.
#Empêcher que ça se reproduise
- Activez la recharge automatique dans Settings → Billing 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.