Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Risoluzione dei problemi relativi AgentCore ai pagamenti
Questa sezione fornisce soluzioni agli errori più comuni durante l'utilizzo dei pagamenti AWS Amazon Bedrock AgentCore .
Errori di convalida
Quando si creano o si aggiornano le risorse di pagamento, il servizio restituisce unValidationException. La tabella seguente elenca gli errori di convalida più comuni e le relative risoluzioni.
| Messaggio di errore | Risoluzione |
|---|---|
|
|
|
|
|
L'ID dell'account |
|
|
Non è |
|
|
Fornisci almeno una configurazione del fornitore di credenziali durante la creazione o l'aggiornamento di un connettore di pagamento. |
|
|
Ogni configurazione del fornitore di credenziali deve includere un. |
|
|
La variante di configurazione del provider di credenziali deve corrispondere al tipo di connettore. Ad esempio, un |
Vengono inoltre applicati i vincoli di denominazione dei campi:
-
I nomi dei gestori dei pagamenti devono iniziare con una lettera e contenere solo caratteri alfanumerici (massimo 48 caratteri).
-
I nomi dei connettori di pagamento seguono le stesse regole ma consentono anche caratteri di sottolineatura.
-
Le descrizioni consentono caratteri alfanumerici e spazi (massimo 4096 caratteri).
Errori di autorizzazione
| Messaggio di errore | Risoluzione |
|---|---|
|
|
Il tuo account è stato limitato. Contatta l' AWS assistenza per risolvere il problema. |
|
|
Il tuo account è in uno stato di accesso limitato. Le operazioni di lettura ed elenco sono consentite, ma le operazioni di creazione e aggiornamento sono limitate fino alla risoluzione della restrizione. |
|
Errori di autorizzazione IAM Sigv4 |
Assicurati che il principale chiamante disponga delle autorizzazioni appropriate. |
|
PassRole guasti |
Quando si fornisce un |
AWS Errori di iscrizione al Market
Quando utilizzi Coinbase come fornitore di servizi di pagamento, il tuo account deve avere un abbonamento attivo all'elenco di Coinbase Wallets for AgentCore Payments nel Marketplace. AWS Se l'abbonamento non è presente, il servizio restituisce un codice SubscriptionRequiredException di stato HTTP 403.
Questo errore viene applicato in due punti:
-
Quando crei un connettore di pagamento Coinbase con.
CreatePaymentConnector -
Quando esegui un'operazione di portafoglio Coinbase sul piano dati, ad esempio
CreatePaymentInstrumento.ProcessPayment
L'eccezione include un subscriptionUrl campo con un link all'elenco del AWS Marketplace e un productName campo che identifica il prodotto che richiede un abbonamento.
| Messaggio di errore | Risoluzione |
|---|---|
|
|
Il tuo account non ha un abbonamento AWS Marketplace attivo per Coinbase. Per risolvere:
Per ulteriori informazioni, consulta Abbonarsi a Coinbase Wallets for AgentCore Payments in Marketplace. AWS |
Errori di autorizzazione alla creazione rapida
La creazione rapida ti consente di configurare un connettore di pagamento Coinbase senza gestire tu stesso le credenziali. Quando chiamiCreatePaymentConnector, il servizio restituisce un. authorizationUrl Apri l'URL (o forniscilo agli utenti della tua applicazione) per completare l'autorizzazione Coinbase. Durante questo flusso, il connettore passa attraverso i seguenti Quick-create-specific stati:
-
PENDING_AUTHENTICATION— Il connettore sta aspettando che tu (o l'utente della tua applicazione) completi l'autorizzazione Coinbase. -
PROVISIONING— L'autorizzazione è completa e il servizio sta effettuando il provisioning del connettore. -
AUTHENTICATION_EXPIRED— ÈauthorizationUrlscaduto prima del completamento dell'autorizzazione. -
AUTHENTICATION_FAILED— L'autorizzazione Coinbase non è andata a buon fine.
La tabella seguente elenca i problemi più comuni di autorizzazione Quick Create e le relative risoluzioni.
| Stato del connettore | Risoluzione |
|---|---|
|
Connettore bloccato |
L'autorizzazione alla creazione rapida non è stata completata. Per risolvere:
|
|
Connector in |
È
|
Errori relativi alla risorsa non trovata
| Messaggio di errore | Risoluzione |
|---|---|
|
|
Il gestore dei pagamenti specificato non esiste. Verifica l'ID chiamando |
|
|
Il connettore specificato non esiste nel gestore specificato. Verifica entrambi gli ID utilizzando |
|
Risorsa non trovata durante |
Il gestore dei pagamenti principale non esiste. Crea prima il gestore dei pagamenti. |
Errori di conflitto
Il servizio restituisce a ConflictException quando due richieste modificano la stessa risorsa contemporaneamente o quando si crea una risorsa già esistente. Riprova la richiesta . Le operazioni di creazione e aggiornamento supportano clientToken un tentativo sicuro.
Errori relativi alle quote di servizio
Il servizio ritorna "{limitType} limit exceeded for account {accountId}" quando raggiungi il numero massimo di gestori di pagamento o connettori per il tuo account. Elimina le risorse inutilizzate o contatta l' AWS assistenza per richiedere un aumento del limite.
Errori di limitazione
Il servizio ritorna "Rate exceeded" quando la frequenza delle richieste supera il limite consentito. Implementa il backoff esponenziale con jitter nella logica dei tentativi. Se raggiungi costantemente i limiti, contatta l'assistenza. AWS
Errori di elaborazione dei pagamenti
Se un fornitore di servizi di pagamento esterno rifiuta la richiesta di firma, il servizio restituisce un AccessDeniedException oValidationException. L'elaborazione dei pagamenti fallisce anche con a SubscriptionRequiredException se il tuo account non ha un abbonamento AWS Marketplace attivo per Coinbase. La tabella seguente elenca gli errori più comuni e le relative risoluzioni.
| Messaggio di errore | Risoluzione |
|---|---|
|
|
Non hai concesso l'autorizzazione di delega che consente al tuo agente di firmare transazioni per tuo conto o l'hai revocata in precedenza. Per risolvere:
Per ulteriori informazioni su un'implementazione frontend che gestisce il flusso di concessione delle deleghe, consulta il AgentCore modello https://github.com/coinbase/cdp-agentcore-template |
|
|
La firma delegata non è configurata per il tuo progetto Coinbase Developer Platform. Per risolvere:
È necessario completare questo passaggio prima che l'agente possa firmare le transazioni per conto degli utenti. |
|
|
Il tuo fornitore di credenziali ha chiavi di autorizzazione del portafoglio Privy non valide o scadute. Per risolvere:
Per ulteriori informazioni sulla configurazione delle credenziali, consulta Privy AgentCore SDK |
|
|
Il tuo account non ha un abbonamento AWS Marketplace attivo per Coinbase. L'elaborazione di un pagamento tramite un portafoglio Coinbase richiede un abbonamento attivo, quindi questo errore può verificarsi se l'abbonamento non è mai stato creato o è stato successivamente annullato. Per risolvere:
Per maggiori informazioni, vedi Abbonarsi a Coinbase Wallets for AgentCore Payments in AWS Marketplace ed Errori di abbonamento al AWS Marketplace. |
errori nelle richieste di pagamento x402
Quando si elabora un pagamento con il protocollo x402, il servizio convalida il payload di pagamento inoltrato paymentInput.cryptoX402 prima che contenga il budget o le firme. Se il payload non è valido o non è supportato, il servizio restituisce un e non consuma alcun budget. ValidationException La tabella seguente elenca gli errori più comuni relativi alle richieste di pagamento x402 e le relative risoluzioni. Alcune righe descrivono gli errori di esecuzione o di liquidazione, ad esempio una transazione di indennità Permit2 rifiutata, che possono verificarsi dopo l'inizio della firma anziché durante la convalida preliminare alla firma.
| Messaggio di errore | Risoluzione |
|---|---|
|
|
Il payload di pagamento x402 non può essere analizzato o convalidato. Copia il payload x402 del venditore dalla risposta esattamente come è stato ricevuto, senza modifiche. |
|
|
Lo strumento di pagamento non specifica una rete. Crea lo strumento di pagamento con una rete che corrisponda al payload di pagamento del commerciante. |
|
|
La rete dello strumento di pagamento non corrisponde alla rete del payload. Utilizza uno strumento di pagamento la cui rete corrisponda alla richiesta di pagamento del commerciante. |
|
|
Il payload non specifica una valuta. Inoltra alla lettera il payload del commerciante. Se l'errore persiste, il payload del merchant non è valido; contatta il merchant. |
|
|
Il payload richiede una valuta non supportata. Utilizza un endpoint commerciale che richiede una valuta supportata. |
|
|
Il payload non specifica un importo. Inoltra alla lettera il payload del commerciante. Se l'errore persiste, il payload del merchant non è valido; contatta il merchant. |
|
|
L'importo del carico utile non è un numero positivo. Inoltra alla lettera il carico utile del commerciante; non modificare l'importo. |
|
|
L'importo del carico utile è superiore al valore massimo consentito. Utilizza un endpoint commerciale il cui importo rientri nell'intervallo consentito. |
|
|
Il payload non specifica un asset. Inoltra alla lettera il payload del commerciante. Se l'errore persiste, il payload del merchant non è valido; contatta il merchant. |
|
|
L'indirizzo dell'asset del payload non è un indirizzo valido per la rete. Inoltra il payload del merchant alla lettera; non modificare l'indirizzo dell'asset. |
|
|
Il payload richiede un token diverso dal canonico USDC per la rete. Utilizza un endpoint commerciale che richiede l'USDC canonico e verifica che la rete dello strumento di pagamento corrisponda al payload. |
|
|
Il payload non specifica uno schema. Inoltra alla lettera il payload del commerciante. Se l'errore persiste, il payload del merchant non è valido; contatta il merchant. |
|
|
Il payload richiede uno schema non supportato. AgentCore i pagamenti supportano gli schemi |
|
|
Lo |
|
|
Lo |
|
|
Hai impostato |
|
|
Il |
|
Il fornitore dei pagamenti ha rifiutato la transazione di indennità Permit2. |
Quando
|
|
|
Il payload non specifica un indirizzo. |
|
|
L'indirizzo del payload non è un |
|
|
Il payload non specifica. |
|
|
Il valore del payload |
|
|
Il valore del payload è superiore |
|
|
Il payload per un pagamento Solana (SVM) non lo specifica. |
|
|
Il payload non include il campo obbligatorio. |
|
|
Il payload per un pagamento EVM non include. |
|
|
Il payload per un pagamento EVM non include. |
|
|
Il payload dello |
|
|
Il payload non |
Errori di contestazione MPP
Quando si elabora un pagamento con il Machine Payments Protocol (MPP), il servizio convalida la richiesta WWW-Authenticate: Payment inoltrata. paymentInput.mpp Convalida la sfida prima di fissare il budget o le firme. Se il problema non è valido, non è supportato o è scaduto, il servizio restituisce un messaggio ValidationException e non consuma alcun budget. La tabella seguente elenca gli errori di contestazione MPP più comuni e le relative risoluzioni. Alcune righe descrivono gli errori di runtime o di accesso, ad esempio un saldo insufficiente del portafoglio, l'accesso MPP non abilitato o un errore nella creazione delle credenziali, anziché errori di convalida prima della firma.
| Messaggio di errore | Risoluzione |
|---|---|
|
|
Fornisci al |
|
|
L'intestazione inoltrata non è una sfida. |
|
|
Nella sfida manca un campo obbligatorio. Per il |
|
|
Il |
|
|
La sfida decodificata non |
|
|
La sfida è troppo lunga |
|
|
Il valore |
|
|
Il |
|
|
L' |
|
|
Un campo di sfida contiene un carattere di controllo non consentito. Inoltra la sfida alla lettera. Se l'errore persiste, la richiesta del commerciante non è valida; contatta il commerciante. |
|
|
La sfida richiede un intento non supportato. AgentCore i pagamenti supportano solo l' |
|
|
La sfida richiede un metodo di pagamento non supportato. AgentCore payments supporta solo i |
|
|
La sfida non offre la modalità pull. AgentCore i pagamenti supportano solo la modalità pull per MPP. |
|
|
Fornisci il |
|
|
La sfida richiede un token diverso dal canonico USDC per la rete. Usa una sfida che richiede l'USDC canonico. Verifica che la rete dello strumento di pagamento corrisponda al metodo di sfida. |
|
|
Il venditore non sponsorizza le tariffe del gas per questa sfida. |
|
|
La sfida è di breve durata ed è scaduta. Richiedi nuovamente la risorsa a pagamento per ottenere una nuova sfida, quindi riprova. Non viene consumato alcun budget per una sfida scaduta. |
|
|
La sfida Solana richiede una rete non supportata. AgentCore supporta solo i pagamenti |
|
|
La sfida Solana richiede commissioni pagate dal cliente. Oggi il |
|
|
Il |
|
|
Il saldo del portafoglio dell'acquirente non è sufficiente per coprire sia l'importo del pagamento che la tariffa di rete (gas). Finanzia il portafoglio con USDC aggiuntivi. Vedi Finanziare il portafoglio e concedere le autorizzazioni agli agenti. |
|
|
L'elaborazione dei pagamenti MPP non è abilitata per il tuo account. Contatta l' AWS assistenza per richiedere l'accesso. |
|
|
Il servizio non è riuscito a creare le credenziali di pagamento a partire dalla sfida. Verifica di aver inoltrato la sfida alla lettera. Se l'errore persiste, contatta l' AWS assistenza con l'ID della richiesta indicato nell'intestazione della risposta. |
Errori server
Il servizio viene restituito in caso "Something went wrong in processing your request" di errori interni. Riprova la richiesta dopo un breve ritardo. Se l'errore persiste, contatta l' AWS assistenza con l'ID della richiesta indicato nell'intestazione della x-amzn-requestid risposta.