Solução de problemas de AgentCore pagamentos

roleArn must contain a valid account ID

roleArnDeve ser um ARN de função do IAM válido com um ID de conta de 12 dígitos. Verifique o formato:arn:aws:iam::<accountId>:role/<roleName>.

roleArn must belong to your account

O ID da conta em roleArn deve corresponder à conta do chamador. Cross-account as funções não são suportadas.

Invalid role ARN: {roleArn}

O não roleArn pôde ser analisado. Verifique o formato ARN.

credentialProviderConfigurations list cannot be empty

Forneça pelo menos uma configuração de provedor de credenciais ao criar ou atualizar um conector de pagamento.

credentialProviderArn is required but not found in the request

Cada configuração do provedor de credenciais deve incluir umacredentialProviderArn. Crie um primeiro usando Criar um provedor de credenciais.

Connector type '{type}' does not match the provided credentialProviderConfiguration

A variante de configuração do provedor de credenciais deve corresponder ao tipo de conector. Por exemplo, um CoinbaseCDP conector requer a coinbaseCDP configuração, nãostripePrivy.

Access denied due to account security restrictions. Contact AWS Support for assistance.

Sua conta foi restrita. Entre em contato com o AWS suporte para resolver.

Access denied for {CREATE|UPDATE} due to account security restrictions. Contact AWS Support for assistance.

Sua conta está em um estado de acesso limitado. As operações de leitura e listagem são permitidas, mas as operações de criação e atualização são restritas até que a restrição seja resolvida.

Falhas de autorização do IAM SigV4

Certifique-se de que o responsável pela chamada tenha as bedrock-agentcore: permissões apropriadas. O serviço usa a assinatura SigV4 com o nome da bedrock-agentcore assinatura.

PassRole fracassos

Ao fornecer umroleArn, o chamador deve ter iam:PassRole permissão para a função. A política de confiança da função deve ser permitida bedrock-agentcore.amazonaws.com como diretor de serviços.

SubscriptionRequiredException(HTTP 403)

Sua conta não tem uma assinatura ativa do AWS Marketplace para a Coinbase. Para resolver:

Para obter mais informações, consulte Inscrever-se em carteiras Coinbase para AgentCore pagamentos no AWS Marketplace.

Conector preso PENDING_AUTHENTICATION

A autorização de criação rápida não foi concluída. Para resolver:

Entrada de conector AUTHENTICATION_EXPIRED

O authorizationUrl expirado, o que acontece cerca de 10 minutos após a CreatePaymentConnector devolução. Para resolver:

Payment manager not found: {managerId}

O gerenciador de pagamentos especificado não existe. Verifique o ID ligandoListPaymentManagers.

Payment connector not found: connectorId={connectorId}, managerId={managerId}

O conector especificado não existe no gerenciador fornecido. Verifique os dois IDs usandoListPaymentConnectors.

Recurso não encontrado durante CreatePaymentConnector

O gerente de pagamento principal não existe. Crie primeiro o gerenciador de pagamentos.

Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.

Você não concedeu a permissão de delegação que permite que seu agente assine transações em seu nome ou a revogou anteriormente. Para resolver:

Para obter mais informações sobre uma implementação de front-end que lida com o fluxo de subsídios de delegação, consulte o AgentCore modelo da Coinbase no site. GitHub Para obter mais informações sobre como financiar a carteira, consulte Financiamento da carteira.

Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.

Seu projeto da Coinbase Developer Platform não tem a assinatura delegada configurada. Para resolver:

Você deve concluir essa etapa antes que seu agente possa assinar transações em nome dos usuários.

Privy credentials are invalid. Please verify the credential configuration.

Seu provedor de credenciais tem chaves de autorização de carteira Privy inválidas ou expiradas. Para resolver:

Para obter mais informações sobre a configuração de credenciais, consulte o AgentCore SDK Privy no site. GitHub

SubscriptionRequiredException(HTTP 403)

Sua conta não tem uma assinatura ativa do AWS Marketplace para a Coinbase. O processamento de um pagamento em uma carteira da Coinbase requer uma assinatura ativa, portanto, esse erro pode ocorrer se a assinatura nunca tiver sido criada ou for cancelada posteriormente. Para resolver:

Para obter mais informações, consulte Inscrever-se em carteiras Coinbase para AgentCore pagamentos no AWS Marketplace e erros de assinatura do AWS Marketplace.

X402 Payload for signing is invalid.

A carga de pagamento x402 não pôde ser analisada ou validada. Copie a carga útil x402 do lojista da 402 Payment Required resposta para paymentInput.cryptoX402 exatamente como foi recebida, sem modificação.

Payment instrument network is required

O instrumento de pagamento não especifica uma rede. Crie o instrumento de pagamento com uma rede que corresponda à carga de pagamento do comerciante.

Network mismatch '{network}' is not supported for paymentNetwork '{paymentNetwork}'. Supported networks: {networks}

A rede do instrumento de pagamento não corresponde à rede na carga útil. Use um instrumento de pagamento cuja rede corresponda à solicitação de pagamento do comerciante.

Payment currency is required

A carga não especifica uma moeda. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Currency '{currency}' is not supported. Supported currencies: {currencies}

A carga solicita uma moeda não suportada. Use um endpoint comercial que solicite uma moeda compatível.

Payment amount is required

A carga não especifica um valor. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment amount must be a positive number. Received: {value}

O valor da carga útil não é um número positivo. Encaminhe a carga útil do lojista na íntegra; não modifique o valor.

Payment amount exceeds maximum allowed value. Received: {value}, Maximum: {max}

O valor da carga está acima do valor máximo permitido. Use um endpoint comercial cujo valor esteja dentro da faixa permitida.

Payment asset is required

A carga não especifica um ativo. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment asset address is invalid. Expected valid address format for the specified network. Received: {value}

O endereço do ativo de carga útil não é um endereço válido para a rede. Encaminhe a carga útil do comerciante na íntegra; não modifique o endereço do ativo.

Payment asset is not a supported USDC token address for network '{network}'. Received: {value}. Expected: {expected}

A carga solicita um token diferente do USDC canônico para a rede. Use um endpoint comercial que solicite USDC canônico e verifique se a rede do instrumento de pagamento corresponde à carga útil.

Payment scheme is required

A carga não especifica um esquema. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment scheme not supported. Supported scheme: {scheme}

A carga útil solicita um esquema não suportado. AgentCore os pagamentos apoiam exact os upto esquemas e. Consulte Pagar uma solicitação de pagamento x402.

Payment scheme 'upto' is only supported on x402 protocol version 2

O upto esquema requer a versão 2 do protocolo x402. versionDefina como 2 in paymentInput.cryptoX402 ou use um endpoint comercial compatível com a versão 2.

Payment scheme 'upto' is only supported on EVM networks. Received network: {network}

O upto esquema é suportado somente em redes EVM. Use um endpoint comercial em uma rede EVM para o esquema. upto

permit2AllowanceLimit is only supported for payment scheme 'upto'. Received scheme: {scheme}

Você definiu permit2AllowanceLimit um esquema diferente deupto. permit2AllowanceLimitDefinido apenas para o upto esquema. Consulte o subsídio Permit2 para até pagamentos.

permit2AllowanceLimit must be a positive integer in the asset’s smallest denomination. Received: {value}

O permit2AllowanceLimit valor não é um número inteiro positivo. Forneça a provisão como um número inteiro positivo na menor denominação do ativo. Por exemplo, 1000000 concede 1 USDC com 6 casas decimais e 115792089237316195423570985008687907853269984665640564039457584007913129639935 (o uint256 valor máximo) concede uma mesada ilimitada.

O provedor de pagamento rejeitou a transação de subsídio Permit2.

Quando ProcessPayment transmite a approve transação para um upto pagamento, o provedor da carteira pode rejeitá-la. Por exemplo, o provedor pode rejeitá-la se a assinatura delegada não for concedida ou se uma transação anterior da mesma carteira ainda não tiver sido confirmada. Para resolver:

Payment payTo address is required

A carga não especifica um payTo endereço. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment payTo address is invalid. Expected valid address format for the specified network. Received: {value}

O payTo endereço da carga não é um endereço válido para a rede. Encaminhe a carga útil do comerciante na íntegra; não modifique o endereço. payTo

Payment maxTimeoutSeconds is required

A carga não especificamaxTimeoutSeconds. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment maxTimeoutSeconds must be positive. Received: {value}

O maxTimeoutSeconds valor da carga útil não é positivo. Encaminhe a carga útil do lojista na íntegra; não modifique o valor.

Payment maxTimeoutSeconds {value} exceeds maximum allowed value of {max}

O maxTimeoutSeconds valor da carga está acima do valor máximo permitido. Use um endpoint comercial cujo tempo limite esteja dentro do intervalo permitido.

Payment feePayer is required for SVM payments

A carga útil de um pagamento Solana (SVM) não é especificada. feePayer Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment extra field is required

A carga não inclui o extra campo obrigatório. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment extra.name is required for EVM payments

A carga útil de um pagamento de EVM não inclui. extra.name Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment extra.version is required for EVM payments

A carga útil de um pagamento de EVM não inclui. extra.version Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment extra.facilitatorAddress is required for the upto scheme

A carga útil do upto esquema não incluiextra.facilitatorAddress. Encaminhe a carga útil do comerciante na íntegra. Se o erro persistir, a carga útil do lojista está malformada; entre em contato com o lojista.

Payment extra.facilitatorAddress is invalid. Expected valid address format for the specified network. Received: {value}

A carga não extra.facilitatorAddress é um endereço válido para a rede. Encaminhe a carga útil do comerciante na íntegra; não modifique o endereço.

MPP wwwAuthenticateHeaders is required and must contain exactly one WWW-Authenticate header.

Forneça ao wwwAuthenticateHeaders campo exatamente um cabeçalho. Copie o WWW-Authenticate: Payment desafio do lojista na íntegra; não envie vários cabeçalhos.

WWW-Authenticate header is not a 'Payment' challenge.

O cabeçalho encaminhado não é um Payment desafio. Encaminhe o WWW-Authenticate cabeçalho da 402 Payment Required resposta do lojista sem modificar seu esquema.

MPP challenge is missing required field: {field}

O desafio não tem um campo obrigatório. Para o evm método, ambos methodDetails.chainId e realm são necessários. Verifique se o desafio do lojista inclui o campo nomeado antes de encaminhá-lo.

MPP challenge 'request' is not valid base64url: {value}

O request valor do desafio não é válido em base64url. Encaminhe o desafio exatamente como o comerciante o devolveu. Não decodifique, recodifique nem modifique o valor.

MPP challenge 'request' is not valid JSON: {value}

O desafio decodificado não request é um JSON válido. Enfrente o desafio na íntegra. Se o erro persistir, o desafio do lojista está malformado; entre em contato com o lojista.

MPP challenge 'id' exceeds the maximum allowed length of {max} characters. Received length: {length}.

O desafio id é muito longo. Encaminhe o desafio sem modificações. Se o erro persistir, o desafio do lojista está malformado; entre em contato com o lojista.

MPP challenge methodDetails.chainId must be a JSON integer, not a string or decimal. Received: {value}

O methodDetails.chainId no desafio deve ser um número inteiro JSON. Encaminhe o desafio na íntegra; não cite nem reformate o valor.

MPP challenge 'request' JSON contains a duplicate key, which is not allowed (RFC 8785 JCS requires unique member names): {key}

O desafio request JSON contém uma chave duplicada. Enfrente o desafio na íntegra. Se o erro persistir, o desafio do lojista está malformado; entre em contato com o lojista.

MPP challenge WWW-Authenticate header contains a duplicate auth-param: {param}

O WWW-Authenticate cabeçalho contém um parâmetro duplicado. Encaminhe o cabeçalho na íntegra. Se o erro persistir, o desafio do lojista está malformado; entre em contato com o lojista.

MPP challenge field '{field}' contains a disallowed control character (0x{code}).

Um campo de desafio contém um caractere de controle não permitido. Enfrente o desafio na íntegra. Se o erro persistir, o desafio do lojista está malformado; entre em contato com o lojista.

MPP supports only the 'charge' intent. Received: {intent}

O desafio solicita uma intenção não suportada. AgentCore os pagamentos suportam apenas a charge intenção do MPP.

MPP supports only the 'evm', 'tempo', and 'solana' methods. Received: {method}

O desafio solicita uma forma de pagamento não suportada. AgentCore os pagamentos suportam somente os solana métodos evmtempo, e para MPP.

MPP supports only pull mode; challenge supportedModes did not include 'pull'.

O desafio não oferece o modo pull. AgentCore os pagamentos suportam apenas o modo pull para MPP.

MPP version is required.

Forneça o version campo empaymentInput.mpp.

MPP EVM/Tempo charge supports only the canonical USDC token on network '{network}'. Received currency: {currency}

O desafio solicita um token diferente do USDC canônico para a rede. Use um desafio que solicite USDC canônico. Verifique se a rede do instrumento de pagamento corresponde ao método de desafio.

This MPP challenge does not offer seller-sponsored network fees (methodDetails.feePayer=false), so the blockchain network (gas) fees would be charged to the buyer’s wallet in addition to the payment amount. Set buyerPaysGasFees=true to authorize paying them, or obtain a challenge whose seller sponsors the fees.

O vendedor não patrocina taxas de gás para esse desafio. buyerPaysGasFees=truepaymentInput.mppPrepare-se para autorizar o pagamento da gasolina da carteira do comprador ou obtenha um desafio cujo vendedor patrocine as taxas. Isso é necessário para o tempo método quando o vendedor não patrocina taxas.

MPP challenge has expired ('expires' is in the past). Obtain a fresh challenge and retry.

O desafio durou pouco e expirou. Solicite o recurso pago novamente para obter um novo desafio e tente novamente. Nenhum orçamento é consumido para um desafio expirado.

MPP Solana charge supports only the 'mainnet' and 'devnet' networks. Received: {network}

O desafio Solana solicita uma rede sem suporte. AgentCore suportes de pagamentos apenas mainnet e devnet para cobranças de Solana MPP.

MPP Solana charge currently supports only server-sponsored fees (methodDetails.feePayer=true). Client-paid fees (feePayer=false) are not yet supported.

O desafio Solana solicita taxas pagas pelo cliente. Atualmente, o solana método suporta apenas taxas patrocinadas pelo servidor. Use um desafio cujo vendedor patrocine as taxas.

Solana MPP payments are not supported for Coinbase-managed payment instruments.

O solana método não é compatível com os instrumentos de pagamento Coinbase CDP. Use um instrumento de pagamento Stripe (Privy) para cobranças do Solana MPP. Consulte o suporte do provedor para cada método em Processar um pagamento.

Insufficient balance in the payer wallet to cover the token transfer and gas fee.

A carteira do comprador não tem saldo suficiente para cobrir o valor do pagamento e a taxa de rede (gás). Financie a carteira com USDC adicional. Consulte Financiar a carteira e conceder permissões ao agente.

Access to MPP (Machine Payments Protocol) payment processing is not enabled for this account. Contact AWS Support for access.

O processamento de pagamentos MPP não está habilitado para sua conta. Entre em contato com o AWS Suporte para solicitar acesso.

Failed to build MPP payment credential: {reason}

O serviço não conseguiu criar a credencial de pagamento a partir do desafio. Verifique se você encaminhou o desafio na íntegra. Se o erro persistir, entre em contato com o AWS Suporte com a ID da solicitação no cabeçalho da x-amzn-requestid resposta.