# Solução de problemas de AgentCore pagamentos Esta seção fornece soluções para erros comuns ao usar AgentCore pagamentos do AWS Amazon Bedrock. ## Erros de validação Ao criar ou atualizar recursos de pagamento, o serviço retorna um`ValidationException`. A tabela a seguir lista os erros comuns de validação e suas resoluções. | Mensagem de erro | Resolução | | --- | --- | | `roleArn must contain a valid account ID` | `roleArn`Deve 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:::role/`. | | `roleArn must belong to your account` | O ID da conta `roleArn` deve corresponder à conta do chamador. Cross-account 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 um`credentialProviderArn`. Crie um primeiro usando [Criar um provedor de credenciais](resource-providers.md). | | `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ão`stripePrivy`. | As restrições de nomenclatura de campo também são impostas: + Os nomes dos gerentes de pagamento devem começar com uma letra e conter somente caracteres alfanuméricos (máximo de 48 caracteres). + Os nomes dos conectores de pagamento seguem as mesmas regras, mas também permitem sublinhados. + As descrições permitem caracteres alfanuméricos e espaços (máximo de 4096 caracteres). ## Erros de permissão | Mensagem de erro | Resolução | | --- | --- | | `Access denied due to account security restrictions. Contact AWS Support for assistance.` | Sua conta foi restrita. Entre em contato com o AWS Support 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 falhas | Ao fornecer um`roleArn`, o chamador deve ter `iam:PassRole` permissão para a função. A política de confiança da função deve permitir `bedrock-agentcore.amazonaws.com` como diretor de serviço. | ## Erros de recurso não encontrado | Mensagem de erro | Resolução | | --- | --- | | `Payment manager not found: {managerId}` | O gerente de pagamento especificado não existe. Verifique o ID ligando`ListPaymentManagers`. | | `Payment connector not found: connectorId={connectorId}, managerId={managerId}` | O conector especificado não existe no gerenciador fornecido. Verifique os dois IDs usando`ListPaymentConnectors`. | | Recurso não encontrado durante `CreatePaymentConnector` | O gerente de pagamento principal não existe. Crie primeiro o gerenciador de pagamentos. | ## Erros de conflito O serviço retorna um `ConflictException` quando duas solicitações modificam o mesmo recurso ao mesmo tempo ou ao criar um recurso que já existe. Repetir a solicitação . Suporte de operações de criação e atualização `clientToken` para novas tentativas seguras. ## Erros de cota de serviço O serviço retorna `"{limitType} limit exceeded for account {accountId}"` quando você atinge o número máximo de gerenciadores ou conectores de pagamento para sua conta. Exclua recursos não utilizados ou entre em contato com o AWS Support para solicitar um aumento de limite. ## Erros de controle de utilização O serviço retorna `"Rate exceeded"` quando a taxa de solicitação excede o limite permitido. Implemente um recuo exponencial com instabilidade em sua lógica de repetição. Se você atingir os limites de forma consistente, entre em contato com o AWS Support. ## Erros no processamento do pagamento Se um provedor de pagamento externo rejeitar a solicitação de assinatura, o serviço retornará um `AccessDeniedException` ou`ValidationException`. A tabela a seguir lista os erros comuns e suas resoluções. | Mensagem de erro | Resolução | | --- | --- | | `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 à delegação a permissão que permite que seu agente assine transações em seu nome, ou você a revogou anteriormente. Para resolver:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Para obter mais informações sobre uma implementação de front-end que lida com o fluxo de concessão de delegação, consulte o [ AgentCore modelo da Coinbase](https://github.com/coinbase/cdp-agentcore-template) no site. GitHub Para obter mais informações sobre como financiar a carteira, consulte [Financiando a carteira](payments-how-it-works.md#payments-how-it-works-funding-wallet). | | `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:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
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:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Para obter mais informações sobre a configuração de credenciais, consulte o [Privy AgentCore SDK no site](https://github.com/privy-io/aws-agentcore-sdk). GitHub | ## Erros de servidor O serviço retorna em `"Something went wrong in processing your request"` caso de erros internos. Tente fazer a solicitação novamente após um breve atraso. Se o erro persistir, entre em contato com o AWS Support com o ID da solicitação no cabeçalho da `x-amzn-requestid` resposta.