Mon agent IA indique qu'un paiement est requis ou que je n'ai plus de jetons. Que faire ?

Sur la plateforme en libre-service, une erreur de paiement s'accompagne d'un lien de paiement : l'utilisateur l'ouvre pour régler, ou attend le renouvellement de la fenêtre d'utilisation avant de relancer l'agent.

1. Jetons épuisés : l'API REST renvoie 402 payment_required avec une upgrade_url et un en-tête Link avec rel="payment" ; un serveur MCP de plateforme renvoie une erreur de paiement avec le même lien (page d'erreur).
2. La fenêtre d'utilisation de 3 heures est épuisée et aucun crédit ne reste : REST répond par une erreur 429 usage_limit_reached avec le délai de renouvellement, un en-tête Retry-After et une upgrade_url pour acheter des crédits ; MCP répond par une erreur de paiement avec les mêmes éléments.
3. Le plafond de dépenses est atteint : 402 payment_required avec le motif spending_cap_reached, jusqu'à la fin de la période ou le relèvement de ce plafond.

Une fois le paiement effectué par l'utilisateur, l'agent interroge GET /v1/account/payment-links/{id} toutes les 5 secondes environ jusqu'à ce que le statut soit « completed », puis réessaie.

L'agent ne peut pas payer par lui-même (un agent peut-il payer ?) ; les crédits ne sont rechargés automatiquement que si l'utilisateur a activé le rechargement automatique. La nécessité pour un assistant de se reconnecter après paiement n'est pas documentée. Voir gérer une erreur 402 et les crédits.

Un quota dans un contrat REST API Casafari est différent : voir quota et jetons.