Il mio agente AI segnala che è richiesto un pagamento o che ho terminato i token. Cosa devo fare?

Sulla piattaforma self-service, un errore di pagamento genera un link di pagamento: l'utente può aprirlo per completare il pagamento, oppure attendere il rinnovo della finestra di utilizzo prima di riprovare.

1. Token esauriti: il REST risponde con 402 payment_required insieme a un upgrade_url e un header Link con rel="payment"; un MCP server della piattaforma risponde a un errore di pagamento con lo stesso link (pagina di errore).
2. Finestra di utilizzo di 3 ore esaurita e assenza di crediti residui: REST restituisce 429 usage_limit_reached indicando il tempo di ripristino, un header Retry-After e un upgrade_url per l'acquisto di crediti; MCP risponde a un errore di pagamento con le medesime indicazioni.
3. Limite di spesa raggiunto: 402 payment_required con la motivazione spending_cap_reached, fino al termine del periodo o all'aumento del limite.

Una volta effettuato il pagamento, l'agente interroga GET /v1/account/payment-links/{id} circa ogni 5 secondi finché lo stato non risulta completato, per poi riprovare.

L'agente non può pagare autonomamente (un agente può pagare?); i crediti vengono ricaricati automaticamente solo se è stata attivata la ricarica automatica. Non è indicato se un assistente debba riconnettersi dopo il pagamento. Consultare gestione di un 402 e crediti.

Una quota in un contratto REST API di Casafari è diversa: consultare quota rispetto ai token.