Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Solución de problemas de AgentCore pagos
En esta sección se ofrecen soluciones a los errores más comunes que se producen al utilizar los AgentCore pagos de AWS Amazon Bedrock.
Errores de validación
Al crear o actualizar los recursos de pago, el servicio devuelve unValidationException. En la siguiente tabla se enumeran los errores de validación más comunes y sus soluciones.
| Mensaje de error | Resolución |
|---|---|
|
|
|
|
|
La ID de la cuenta |
|
|
No se |
|
|
Proporcione al menos una configuración de proveedor de credenciales al crear o actualizar un conector de pago. |
|
|
Cada configuración de proveedor de credenciales debe incluir un. |
|
|
La variante de configuración del proveedor de credenciales debe coincidir con el tipo de conector. Por ejemplo, un |
También se aplican restricciones de nomenclatura de campos:
-
Los nombres de los administradores de pagos deben empezar por una letra y contener solo caracteres alfanuméricos (máximo 48 caracteres).
-
Los nombres de los conectores de pago siguen las mismas reglas, pero también permiten usar guiones bajos.
-
Las descripciones admiten caracteres alfanuméricos y espacios (4096 caracteres como máximo).
Errores de permisos
| Mensaje de error | Resolución |
|---|---|
|
|
Se ha restringido tu cuenta. Ponte en contacto con AWS el equipo de soporte para solucionarlo. |
|
|
Tu cuenta tiene un estado de acceso limitado. Se permiten las operaciones de lectura y creación de listas, pero las de creación y actualización están restringidas hasta que se resuelva la restricción. |
|
Errores de autorización de SigV4 de IAM |
Asegúrese de que el principal llamante tenga los permisos adecuados |
|
PassRole errores |
Al proporcionar un |
AWS Errores de suscripción a Marketplace
Cuando utilizas Coinbase como proveedor de pagos, tu cuenta debe tener una suscripción activa a la lista de AgentCore monederos para pagos de Coinbase de Marketplace. AWS Si falta la suscripción, el servicio devuelve una SubscriptionRequiredException con un código de estado HTTP 403.
Este error se aplica en dos lugares:
-
Cuando creas un conector de pagos de Coinbase con
CreatePaymentConnector. -
Cuando realizas una operación de monedero de Coinbase en el plano de datos, como
CreatePaymentInstrumento.ProcessPayment
La excepción incluye un subscriptionUrl campo con un enlace a la lista de AWS Marketplace y un productName campo que identifica el producto que requiere una suscripción.
| Mensaje de error | Resolución |
|---|---|
|
|
Tu cuenta no tiene una suscripción activa a AWS Marketplace para Coinbase. Para resolverlo:
Para obtener más información, consulta Suscríbete a Coinbase Wallets for AgentCore Payments in Marketplace. AWS |
Errores de autorización de creación rápida
La creación rápida te permite configurar un conector de pagos de Coinbase sin tener que gestionar tú mismo las credenciales. Cuando llamasCreatePaymentConnector, el servicio devuelve unauthorizationUrl. Abre la URL (o entrégala a los usuarios de tu aplicación) para completar la autorización de Coinbase. Durante este flujo, el conector pasa por los siguientes Quick-create-specific estados:
-
PENDING_AUTHENTICATION— El conector está esperando a que usted (o el usuario de su aplicación) complete la autorización de Coinbase. -
PROVISIONING— La autorización está completa y el servicio está aprovisionando el conector. -
AUTHENTICATION_EXPIRED—authorizationUrlExpiró antes de que se completara la autorización. -
AUTHENTICATION_FAILED— La autorización de Coinbase no tuvo éxito.
En la siguiente tabla se enumeran los problemas comunes de autorización de creación rápida y sus soluciones.
| Estado del conector | Resolución |
|---|---|
|
El conector está atascado |
La autorización de creación rápida no se ha completado. Para resolverlo:
|
|
Conector: |
El
|
Errores en el recurso no encontrado
| Mensaje de error | Resolución |
|---|---|
|
|
El administrador de pagos especificado no existe. Verifica la identificación llamando |
|
|
El conector especificado no existe en el administrador indicado. Verifique ambos ID usando |
|
No se encontró el recurso durante |
El administrador de pagos principal no existe. Crea primero el gestor de pagos. |
Errores de conflicto
El servicio devuelve un ConflictException cuando dos solicitudes modifican el mismo recurso al mismo tiempo o cuando se crea un recurso que ya existe. Intente realizar de nuevo la solicitud . Las operaciones de creación y actualización admiten un clientToken reintento seguro.
Errores de cuota de servicio
El servicio vuelve a "{limitType} limit exceeded for account {accountId}" funcionar cuando alcanzas el número máximo de gestores o conectores de pago para tu cuenta. Elimina los recursos no utilizados o ponte en contacto con el equipo de AWS soporte para solicitar un aumento del límite.
Errores de limitación
El servicio vuelve a "Rate exceeded" funcionar cuando la tasa de solicitudes supera el límite permitido. Implemente un retroceso exponencial con fluctuación en su lógica de reintentos. Si siempre alcanzas los límites, ponte en contacto con el equipo de soporte. AWS
Errores en el procesamiento de pagos
Si un proveedor de pagos externo rechaza la solicitud de firma, el servicio devuelve un AccessDeniedException oValidationException. El procesamiento de pagos también falla SubscriptionRequiredException si tu cuenta no tiene una suscripción activa de AWS Marketplace para Coinbase. La siguiente tabla muestra los errores más comunes y sus soluciones.
| Mensaje de error | Resolución |
|---|---|
|
|
No has otorgado el permiso de delegación que permite a tu agente firmar transacciones en tu nombre, o lo has revocado anteriormente. Para resolverlo:
Para obtener más información sobre una implementación de interfaz que gestione el flujo de concesiones de delegación, consulta la AgentCore plantilla de Coinbase |
|
|
Tu proyecto de la plataforma para desarrolladores de Coinbase no tiene configurada la firma delegada. Para resolverlo:
Debe completar este paso para que su agente pueda firmar las transacciones en nombre de los usuarios. |
|
|
Las claves de autorización de Privy Wallet de tu proveedor de credenciales no son válidas o están caducadas. Para resolverlo:
Para obtener más información sobre la configuración de las credenciales, consulte el Privy AgentCore SDK |
|
|
Tu cuenta no tiene una suscripción activa a AWS Marketplace para Coinbase. El procesamiento de un pago con un monedero de Coinbase requiere una suscripción activa, por lo que este error puede producirse si la suscripción nunca se creó o se canceló posteriormente. Para resolverlo:
Para obtener más información, consulta Suscríbete a Coinbase Wallets for AgentCore Payments in AWS Marketplace y Errores de suscripción a AWS Marketplace. |
Errores en las solicitudes de pago x402
Cuando procesas un pago con el protocolo x402, el servicio valida la carga útil del pago que has reenviado paymentInput.cryptoX402 antes de retener el presupuesto o firmar. Si la carga útil está mal formada o no es compatible, el servicio devuelve un y no consume ningún presupuesto. ValidationException En la siguiente tabla se enumeran los errores más comunes en las solicitudes de pago x402 y sus soluciones. En algunas filas se describen los errores de ejecución o de liquidación, como el rechazo de una transacción de asignación de Permit2, que pueden producirse después del inicio de la firma y no durante la validación previa a la firma.
| Mensaje de error | Resolución |
|---|---|
|
|
No se pudo analizar ni validar la carga útil del pago x402. Copia la carga útil x402 del vendedor de la |
|
|
El instrumento de pago no especifica ninguna red. Crea el instrumento de pago con una red que coincida con la carga útil de pago del comerciante. |
|
|
La red del instrumento de pago no coincide con la red de la carga útil. Usa un instrumento de pago cuya red coincida con la solicitud de pago del comerciante. |
|
|
La carga útil no especifica ninguna divisa. Reenvía la carga útil del vendedor literalmente. Si el error persiste, significa que la carga útil del vendedor tiene un formato incorrecto; ponte en contacto con el vendedor. |
|
|
La carga útil solicita una moneda no admitida. Usa un terminal comercial que solicite una divisa admitida. |
|
|
La carga útil no especifica un importe. Reenvía la carga útil del vendedor literalmente. Si el error persiste, significa que la carga útil del vendedor tiene un formato incorrecto; ponte en contacto con el vendedor. |
|
|
El importe de la carga útil no es un número positivo. Reenvía la carga útil del vendedor literalmente; no modifiques el importe. |
|
|
El importe de la carga útil supera el valor máximo permitido. Usa un punto final para comerciantes cuyo importe esté dentro del rango permitido. |
|
|
La carga útil no especifica ningún activo. Reenvía la carga útil del vendedor literalmente. Si el error persiste, significa que la carga útil del vendedor tiene un formato incorrecto; ponte en contacto con el vendedor. |
|
|
La dirección del activo de carga no es una dirección válida para la red. Reenvía la carga útil del comerciante literalmente; no modifiques la dirección del activo. |
|
|
La carga útil solicita un token que no sea el USDC canónico de la red. Usa un terminal comercial que solicite el USDC canónico y verifica que la red del instrumento de pago coincida con la carga útil. |
|
|
La carga útil no especifica ningún esquema. Reenvía la carga útil del vendedor literalmente. Si el error persiste, significa que la carga útil del vendedor tiene un formato incorrecto; ponte en contacto con el vendedor. |
|
|
La carga útil solicita un esquema no compatible. AgentCore Los pagos son compatibles con los esquemas |
|
|
El |
|
|
El |
|
|
|
|
|
El |
|
El proveedor de pagos rechazó la transacción de asignación de Permit2. |
Cuando
|
|
|
La carga útil no especifica una dirección. |
|
|
La dirección de carga útil no es una |
|
|
La carga útil no lo especifica. |
|
|
El |
|
|
El valor de la carga útil está por encima del |
|
|
La carga útil de un pago de Solana (SVM) no se especifica. |
|
|
La carga útil no incluye el campo obligatorio. |
|
|
La carga útil de un pago de EVM no incluye. |
|
|
La carga útil de un pago de EVM no incluye. |
|
|
La carga útil del |
|
|
La carga útil no |
Errores en la impugnación del MPP
Cuando procesas un pago con el Protocolo de pagos automáticos (MPP), el servicio valida el WWW-Authenticate: Payment desafío que envías. paymentInput.mpp Valida la impugnación antes de contener el presupuesto o las señales. Si el desafío tiene un formato incorrecto, no es compatible o ha caducado, el servicio devuelve un ValidationException y no consume ningún presupuesto. En la siguiente tabla se enumeran los errores más comunes de las impugnaciones del MPP y sus soluciones. Algunas filas describen errores de tiempo de ejecución o de acceso, como un saldo insuficiente de la cartera, la falta de acceso al MPP o un error en la creación de credenciales, en lugar de errores de validación antes de la firma.
| Mensaje de error | Resolución |
|---|---|
|
|
Proporcione al |
|
|
El encabezado reenviado no es un desafío. |
|
|
Falta un campo obligatorio en el desafío. Para el |
|
|
El |
|
|
El desafío decodificado no |
|
|
El desafío |
|
|
El |
|
|
El |
|
|
El |
|
|
Un campo de desafío contiene un carácter de control no permitido. Reenvía el desafío literalmente. Si el error persiste, significa que la impugnación del vendedor es incorrecta; ponte en contacto con el vendedor. |
|
|
El desafío solicita una intención no respaldada. AgentCore Los pagos solo respaldan la |
|
|
El desafío solicita un método de pago no admitido. AgentCore Los pagos solo admiten los |
|
|
El desafío no ofrece el modo de tracción. AgentCore Payments solo admite el modo pull para MPP. |
|
|
Introduzca el |
|
|
El desafío solicita un token que no sea el USDC canónico de la red. Usa un desafío que solicite un USDC canónico. Verifica que la red del instrumento de pago coincida con el método de verificación. |
|
|
El vendedor no patrocina las tarifas de gas para este desafío. |
|
|
El desafío es de corta duración y ha caducado. Vuelve a solicitar el recurso pagado para obtener un desafío nuevo y vuelve a intentarlo. No se consume ningún presupuesto para un desafío caducado. |
|
|
El desafío de Solana solicita una red no compatible. AgentCore solo se admiten pagos |
|
|
El desafío de Solana exige comisiones pagadas por el cliente. En la actualidad, el |
|
|
El |
|
|
El monedero del comprador no tiene saldo suficiente para cubrir tanto el importe del pago como la tarifa de red (gas). Deposita fondos en el monedero con USDC adicionales. Consulta Financiar el monedero y conceder permisos a los agentes. |
|
|
El procesamiento de pagos mediante MPP no está activado en tu cuenta. Ponte en contacto con AWS el equipo de soporte para solicitar el acceso. |
|
|
El servicio no pudo crear la credencial de pago a partir del desafío. Compruebe que ha enviado la impugnación textualmente. Si el error persiste, ponte en contacto con el equipo de AWS soporte con el identificador de la solicitud que aparece en el encabezado de la |
Errores del servidor
El servicio regresa en "Something went wrong in processing your request" caso de errores internos. Vuelva a intentar la solicitud después de esperar unos segundos. Si el error persiste, ponte en contacto con el servicio de AWS asistencia con el identificador de la solicitud que aparece en el encabezado de la x-amzn-requestid respuesta.
