Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Résolution des problèmes de AgentCore paiement
Cette section propose des solutions aux erreurs courantes lors de l'utilisation des AgentCore paiements AWS Amazon Bedrock.
Erreurs de validation
Lors de la création ou de la mise à jour de ressources de paiement, le service renvoie unValidationException. Le tableau suivant répertorie les erreurs de validation courantes et leurs résolutions.
| Message d’erreur | Résolution |
|---|---|
|
|
|
|
|
L'identifiant de compte saisi |
|
|
Le n' |
|
|
Fournissez au moins une configuration de fournisseur d'informations d'identification lors de la création ou de la mise à jour d'un connecteur de paiement. |
|
|
Chaque configuration de fournisseur d'informations d'identification doit inclure un |
|
|
La variante de configuration du fournisseur d'informations d'identification doit correspondre au type de connecteur. Par exemple, un |
Les contraintes de dénomination des champs sont également appliquées :
-
Les noms des gestionnaires de paiement doivent commencer par une lettre et contenir uniquement des caractères alphanumériques (48 caractères maximum).
-
Les noms des connecteurs de paiement suivent les mêmes règles mais autorisent également les soulignements.
-
Les descriptions peuvent contenir des caractères alphanumériques et des espaces (maximum 4 096 caractères).
Erreurs d'autorisation
| Message d’erreur | Résolution |
|---|---|
|
|
Votre compte a été restreint. Contactez le AWS support pour résoudre le problème. |
|
|
L'accès à votre compte est limité. Les opérations de lecture et de liste sont autorisées, mais les opérations de création et de mise à jour sont limitées jusqu'à ce que la restriction soit résolue. |
|
Défaillances d'autorisation IAM SIGv4 |
Assurez-vous que le principal appelant dispose des |
|
PassRole échecs |
Lorsque vous fournissez un |
AWS Erreurs d'abonnement à la place
Lorsque vous utilisez Coinbase en tant que fournisseur de paiement, votre compte doit disposer d'un abonnement actif à la liste des portefeuilles Coinbase pour les AgentCore paiements sur Marketplace AWS . Si l'abonnement est manquant, le service renvoie un SubscriptionRequiredException avec un code d'état HTTP 403.
Cette erreur est appliquée à deux endroits :
-
Lorsque vous créez un connecteur de paiement Coinbase avec
CreatePaymentConnector. -
Lorsque vous effectuez une opération de portefeuille Coinbase sur le plan de données, telle que
CreatePaymentInstrumentouProcessPayment.
L'exception inclut un subscriptionUrl champ contenant un lien vers la liste de AWS Marketplace et un productName champ identifiant le produit nécessitant un abonnement.
| Message d’erreur | Résolution |
|---|---|
|
|
Votre compte n'a pas d'abonnement AWS Marketplace actif pour Coinbase. Pour résoudre le problème :
Pour plus d'informations, consultez la section S'abonner aux portefeuilles Coinbase pour les AgentCore paiements AWS sur Marketplace. |
Création rapide d'erreurs d'autorisation
Quick Create vous permet de configurer un connecteur de paiement Coinbase sans gérer vous-même les informations d'identification. Lorsque vous appelezCreatePaymentConnector, le service renvoie unauthorizationUrl. Ouvrez l'URL (ou fournissez-la aux utilisateurs de votre application) pour terminer l'autorisation Coinbase. Au cours de ce flux, le connecteur passe par les Quick-create-specific états suivants :
-
PENDING_AUTHENTICATION— Le connecteur attend que vous (ou l'utilisateur de votre application) complétiez l'autorisation Coinbase. -
PROVISIONING— L'autorisation est terminée et le service provisionne le connecteur. -
AUTHENTICATION_EXPIRED—authorizationUrlExpiré avant la fin de l'autorisation. -
AUTHENTICATION_FAILED— L'autorisation de Coinbase n'a pas abouti.
Le tableau suivant répertorie les problèmes d'autorisation de création rapide courants et leurs solutions.
| État du connecteur | Résolution |
|---|---|
|
Connecteur coincé |
L'autorisation de création rapide n'est pas terminée. Pour résoudre le problème :
|
|
Connecteur en |
L'
|
Erreurs liées à la ressource introuvable
| Message d’erreur | Résolution |
|---|---|
|
|
Le gestionnaire de paiement spécifié n'existe pas. Vérifiez l'identité en appelant |
|
|
Le connecteur spécifié n'existe pas dans le gestionnaire donné. Vérifiez les deux identifiants à l'aide de |
|
Ressource introuvable pendant |
Le gestionnaire de paiement parent n'existe pas. Créez d'abord le gestionnaire de paiement. |
Erreurs de conflit
Le service renvoie un ConflictException lorsque deux demandes modifient la même ressource en même temps, ou lors de la création d'une ressource qui existe déjà. Réitérez la demande. Créez et mettez à jour le support des opérations clientToken pour des nouvelles tentatives en toute sécurité.
Erreurs liées aux quotas de service
Le service revient "{limitType} limit exceeded for account {accountId}" lorsque vous atteignez le nombre maximum de gestionnaires de paiement ou de connecteurs pour votre compte. Supprimez les ressources inutilisées ou contactez le AWS support pour demander une augmentation de la limite.
Erreur de Limitation
Le service revient "Rate exceeded" lorsque le taux de demandes dépasse la limite autorisée. Implémentez un ralentissement exponentiel avec gigue dans votre logique de nouvelle tentative. Si vous atteignez régulièrement des limites, contactez AWS le support.
Erreurs de traitement des paiements
Si un fournisseur de paiement externe rejette la demande de signature, le service renvoie un AccessDeniedException ouValidationException. Le traitement des paiements échoue également SubscriptionRequiredException si votre compte ne dispose pas d'un abonnement AWS Marketplace actif pour Coinbase. Le tableau suivant répertorie les erreurs courantes et leur résolution.
| Message d’erreur | Résolution |
|---|---|
|
|
Vous n'avez pas accordé l'autorisation de délégation qui permet à votre agent de signer des transactions en votre nom, ou vous l'avez précédemment révoquée. Pour résoudre le problème :
Pour plus d'informations sur une implémentation frontend qui gère le flux d'autorisation de délégation, consultez le AgentCore modèle Coinbase |
|
|
La signature déléguée n'est pas configurée pour votre projet Coinbase Developer Platform. Pour résoudre le problème :
Vous devez effectuer cette étape avant que votre agent puisse signer des transactions pour le compte des utilisateurs. |
|
|
Les clés d'autorisation de votre portefeuille privé ne sont pas valides ou ont expiré auprès de votre fournisseur d'informations d'identification. Pour résoudre le problème :
Pour plus d'informations sur la configuration des informations d'identification, consultez le AgentCore SDK Privy |
|
|
Votre compte n'a pas d'abonnement AWS Marketplace actif pour Coinbase. Le traitement d'un paiement par le biais d'un portefeuille Coinbase nécessite un abonnement actif. Cette erreur peut donc se produire si l'abonnement n'a jamais été créé ou a été annulé ultérieurement. Pour résoudre le problème :
Pour plus d'informations, consultez Abonnement aux portefeuilles Coinbase pour les AgentCore paiements AWS sur Marketplace et Erreurs d'abonnement à AWS Marketplace. |
erreurs de demande de paiement x402
Lorsque vous traitez un paiement à l'aide du protocole x402, le service valide la charge utile du paiement que vous transférez paymentInput.cryptoX402 avant de détenir le budget ou de signer. Si la charge utile est mal formée ou n'est pas prise en charge, le service renvoie un ValidationException et ne consomme aucun budget. Le tableau suivant répertorie les erreurs de demande de paiement x402 courantes et leur résolution. Quelques lignes décrivent les échecs d'exécution ou de règlement, tels qu'une transaction d'allocation Permit2 rejetée, qui peuvent survenir après le début de la signature plutôt que pendant la validation préalable à la signature.
| Message d’erreur | Résolution |
|---|---|
|
|
La charge utile de paiement x402 n'a pas pu être analysée ou validée. Copiez la charge utile x402 du marchand depuis la |
|
|
L'instrument de paiement ne spécifie pas de réseau. Créez l'instrument de paiement avec un réseau correspondant à la charge utile de paiement du commerçant. |
|
|
Le réseau de l'instrument de paiement ne correspond pas au réseau de la charge utile. Utilisez un instrument de paiement dont le réseau correspond à la demande de paiement du commerçant. |
|
|
La charge utile ne spécifie pas de devise. Transférez la charge utile du marchand mot pour mot. Si l'erreur persiste, cela signifie que la charge utile du vendeur est défectueuse ; contactez le vendeur. |
|
|
La charge utile demande une devise non prise en charge. Utilisez un terminal marchand qui demande une devise prise en charge. |
|
|
La charge utile ne spécifie pas de montant. Transférez la charge utile du marchand mot pour mot. Si l'erreur persiste, cela signifie que la charge utile du vendeur est défectueuse ; contactez le vendeur. |
|
|
Le montant de la charge utile n'est pas un nombre positif. Transférez la charge utile du marchand mot pour mot ; ne modifiez pas le montant. |
|
|
Le montant de la charge utile est supérieur à la valeur maximale autorisée. Utilisez un terminal marchand dont le montant se situe dans la fourchette autorisée. |
|
|
La charge utile ne spécifie pas d'actif. Transférez la charge utile du marchand mot pour mot. Si l'erreur persiste, cela signifie que la charge utile du vendeur est défectueuse ; contactez le vendeur. |
|
|
L'adresse de l'actif de charge utile n'est pas une adresse valide pour le réseau. Transférez la charge utile du marchand mot pour mot ; ne modifiez pas l'adresse de l'actif. |
|
|
La charge utile demande un jeton autre que l'USDC canonique pour le réseau. Utilisez un terminal marchand qui demande l'USDC canonique et vérifiez que le réseau de l'instrument de paiement correspond à la charge utile. |
|
|
La charge utile ne spécifie pas de schéma. Transférez la charge utile du marchand mot pour mot. Si l'erreur persiste, cela signifie que la charge utile du vendeur est défectueuse ; contactez le vendeur. |
|
|
La charge utile demande un schéma non pris en charge. AgentCore les paiements soutiennent les |
|
|
Le |
|
|
Le |
|
|
Vous avez défini |
|
|
La |
|
Le fournisseur de paiement a rejeté la transaction d'allocation Permit2. |
Lors de la
|
|
|
La charge utile ne spécifie pas d' |
|
|
L' |
|
|
La charge utile ne le précise |
|
|
La |
|
|
La |
|
|
La charge utile d'un paiement Solana (SVM) n'est pas spécifiée. |
|
|
La charge utile ne comprend pas le |
|
|
La charge utile d'un paiement EVM n'inclut pas. |
|
|
La charge utile d'un paiement EVM n'inclut pas. |
|
|
La charge utile du |
|
|
La charge utile n' |
Erreurs de défi MPP
Lorsque vous traitez un paiement à l'aide du protocole MPP (Machine Payments Protocol), le service valide le WWW-Authenticate: Payment challenge que vous transmettez. paymentInput.mpp Il valide le défi avant qu'il ne débloque le budget ou ne signe. Si le challenge est mal formé, n'est pas pris en charge ou a expiré, le service renvoie un message ValidationException et ne consomme aucun budget. Le tableau suivant répertorie les erreurs de challenge MPP courantes et leurs résolutions. Certaines lignes décrivent des erreurs d'exécution ou d'accès, telles qu'un solde de portefeuille insuffisant, un accès MPP non activé ou un échec de création des informations d'identification, plutôt que des erreurs de validation avant la signature.
| Message d’erreur | Résolution |
|---|---|
|
|
Fournissez au |
|
|
L'en-tête transféré n'est pas un |
|
|
Il manque un champ obligatoire au challenge. Pour la |
|
|
La |
|
|
Le challenge décodé n' |
|
|
Le défi |
|
|
Le |
|
|
Le |
|
|
L' |
|
|
Un champ de défi contient un caractère de contrôle non autorisé. Transmettez le défi mot pour mot. Si l'erreur persiste, cela signifie que le challenge du vendeur est incorrect ; contactez le vendeur. |
|
|
Le défi demande une intention non étayée. AgentCore les paiements ne soutiennent que l' |
|
|
Le challenge demande un mode de paiement non pris en charge. AgentCore les paiements ne prennent en charge que les |
|
|
Le challenge ne propose pas de mode pull. AgentCore les paiements ne prennent en charge que le mode pull pour MPP. |
|
|
Indiquez le |
|
|
Le challenge demande un jeton autre que l'USDC canonique pour le réseau. Utilisez un défi qui demande l'USDC canonique. Vérifiez que le réseau de l'instrument de paiement correspond à la méthode de challenge. |
|
|
Le vendeur ne sponsorise pas les frais d'essence pour ce défi. Activez |
|
|
Le challenge est de courte durée et a expiré. Demandez à nouveau la ressource payante pour obtenir un nouveau défi, puis réessayez. Aucun budget n'est utilisé pour un défi arrivé à expiration. |
|
|
Le défi Solana demande un réseau non pris en charge. AgentCore supports de paiement uniquement |
|
|
Le défi Solana demande des frais payés par le client. La |
|
|
La |
|
|
Le solde du portefeuille de l'acheteur n'est pas suffisant pour couvrir à la fois le montant du paiement et les frais de réseau (gaz). Financez le portefeuille avec des USDC supplémentaires. Consultez Financer le portefeuille et accorder des autorisations aux agents. |
|
|
Le traitement des paiements MPP n'est pas activé pour votre compte. Contactez AWS le support pour demander l'accès. |
|
|
Le service n'a pas pu créer l'identifiant de paiement à partir de ce défi. Vérifiez que vous avez transmis le défi mot pour mot. Si l'erreur persiste, contactez le AWS support à l'aide de l'ID de demande indiqué dans l'en-tête de la |
Erreurs de serveur
Le service revient en "Something went wrong in processing your request" cas d'erreur interne. Réessayez la demande après un bref délai. Si l'erreur persiste, contactez le AWS support à l'aide de l'ID de demande indiqué dans l'en-tête de la x-amzn-requestid réponse.
