Ο AI agent μου αναφέρει ότι απαιτείται πληρωμή ή ότι ξέμεινα από tokens. Τι πρέπει να κάνω;

Στην πλατφόρμα αυτοεξυπηρέτησης, ένα σφάλμα πληρωμής συνοδεύεται από έναν σύνδεσμο πληρωμής: ο χρήστης τον ανοίγει και πληρώνει, ή περιμένει την ανανέωση του παραθύρου χρήσης για να επαναλάβει την κλήση ο πράκτορας.

1. Τα tokens εξαντλήθηκαν: το REST επιστρέφει 402 payment_required μαζί με ένα upgrade_url και μια κεφαλίδα Link με rel="payment"· ένας MCP server της πλατφόρμας επιστρέφει σφάλμα πληρωμής με τον ίδιο σύνδεσμο (σελίδα σφάλματος).
2. Ένα παράθυρο χρήσης 3 ωρών εξαντλήθηκε και δεν απομένουν διαθέσιμα credits: Το REST επιστρέφει 429 usage_limit_reached με τον χρόνο αναπλήρωσης, μια κεφαλίδα Retry-After και ένα upgrade_url για την αγορά credits· το MCP επιστρέφει ένα σφάλμα πληρωμής με τα ίδια στοιχεία.
3. Το όριο δαπανών επιτεύχθηκε: 402 payment_required με αιτιολογία spending_cap_reached, μέχρι τη λήξη της περιόδου ή την αύξηση του ορίου.

Μόλις ο χρήστης ολοκληρώσει την πληρωμή, ο agent ελέγχει περιοδικά με GET /v1/account/payment-links/{id} κάθε 5 δευτερόλεπτα περίπου μέχρι η κατάσταση να γίνει completed και στη συνέχεια επαναλαμβάνει το αίτημα.

Ο agent δεν μπορεί να πραγματοποιήσει πληρωμή μόνος του (μπορεί ένας agent να πληρώσει;)· τα credits ανανεώνονται αυτόματα μόνο εάν ο χρήστης έχει ενεργοποιήσει την αυτόματη ανανέωση. Δεν υπάρχει επίσημη οδηγία για το αν ένας βοηθός χρειάζεται επανασύνδεση μετά την πληρωμή. Δείτε σχετικά με τη διαχείριση του σφάλματος 402 και τα credits.

Το όριο χρήσης (quota) σε ένα συμβόλαιο Casafari REST API λειτουργεί διαφορετικά: δείτε quota έναντι tokens.