AgentCore 결제 문제 해결

roleArn must contain a valid account ID

는 12자리 계정 ID가 있는 유효한 IAM 역할 ARN이어야 roleArn 합니다. 형식을 확인합니다arn:aws:iam::<accountId>:role/<roleName>.

roleArn must belong to your account

의 계정 ID는 호출자의 계정과 일치해야 roleArn 합니다. 교차 계정 역할은 지원되지 않습니다.

Invalid role ARN: {roleArn}

를 구문 분석할 수 roleArn 없습니다. ARN 형식을 확인합니다.

credentialProviderConfigurations list cannot be empty

결제 커넥터를 생성하거나 업데이트할 때 하나 이상의 자격 증명 공급자 구성을 제공합니다.

credentialProviderArn is required but not found in the request

각 자격 증명 공급자 구성에는가 포함되어야 합니다credentialProviderArn. 자격 증명 공급자 생성을 사용하여 먼저 하나를 생성합니다.

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

자격 증명 공급자 구성 변형은 커넥터 유형과 일치해야 합니다. 예를 들어 CoinbaseCDP 커넥터에는가 아닌 coinbaseCDP 구성이 필요합니다stripePrivy.

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

계정이 제한되었습니다. 해결하려면 AWS Support에 문의하세요.

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

계정이 제한된 액세스 상태입니다. 읽기 및 나열 작업은 허용되지만 제한이 해결될 때까지 생성 및 업데이트 작업은 제한됩니다.

IAM SigV4 권한 부여 실패

호출 보안 주체에 적절한 bedrock-agentcore: 권한이 있는지 확인합니다. 서비스는 서명 이름과 함께 SigV4 bedrock-agentcore 서명을 사용합니다.

PassRole 실패

를 제공할 때 호출roleArn자는 역할에 대한 iam:PassRole 권한이 있어야 합니다. 역할의 신뢰 정책은를 서비스 보안 주체bedrock-agentcore.amazonaws.com로 허용해야 합니다.

SubscriptionRequiredException (HTTP 403)

계정에 Coinbase에 대한 활성 AWS Marketplace 구독이 없습니다. 이 문제를 해결하려면:

자세한 내용은 AWS Marketplace에서 AgentCore 결제를 위한 Coinbase Wallets 구독을 참조하세요.

커넥터가 멈춤 PENDING_AUTHENTICATION

빠른 생성 권한 부여가 완료되지 않았습니다. 이 문제를 해결하려면:

의 커넥터 AUTHENTICATION_EXPIRED

authorizationUrl 만료된는 CreatePaymentConnector에서 반환한 후 약 10분 후에 발생합니다. 이 문제를 해결하려면:

Payment manager not found: {managerId}

지정된 결제 관리자가 존재하지 않습니다. 를 호출하여 ID를 확인합니다ListPaymentManagers.

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

지정된 관리자 아래에 지정된 커넥터가 없습니다. IDs를 모두 확인합니다ListPaymentConnectors.

에서 리소스를 찾을 수 없음 CreatePaymentConnector

상위 결제 관리자가 존재하지 않습니다. 먼저 결제 관리자를 생성합니다.

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

에이전트가 사용자를 대신하여 트랜잭션에 서명하도록 허용하는 위임 권한을 부여하지 않았거나 이전에 트랜잭션을 취소했습니다. 이 문제를 해결하려면:

위임 권한 부여 흐름을 처리하는 프런트엔드 구현에 대한 자세한 내용은 GitHub 웹 사이트의 Coinbase AgentCore 템플릿을 참조하세요. Wallet 자금 조달에 대한 자세한 내용은 Wallet 자금 조달을 참조하세요.

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

Coinbase 개발자 플랫폼 프로젝트에 위임된 서명이 구성되어 있지 않습니다. 이 문제를 해결하려면:

에이전트가 사용자를 대신하여 트랜잭션에 서명하려면 먼저이 단계를 완료해야 합니다.

Privy credentials are invalid. Please verify the credential configuration.

자격 증명 공급자에 유효하지 않거나 만료된 Privy wallet 권한 부여 키가 있습니다. 이 문제를 해결하려면:

자격 증명 구성에 대한 자세한 내용은 GitHub 웹 사이트의 Privy AgentCore SDK를 참조하세요.

SubscriptionRequiredException (HTTP 403)

계정에 Coinbase에 대한 활성 AWS Marketplace 구독이 없습니다. Coinbase Wallet에 대한 결제를 처리하려면 활성 구독이 필요하므로 구독이 생성되지 않았거나 나중에 취소된 경우이 오류가 발생할 수 있습니다. 이 문제를 해결하려면:

자세한 내용은 AWS Marketplace에서 AgentCore Payments용 Coinbase Wallets 구독 및 AWS Marketplace 구독 오류를 참조하세요.

X402 Payload for signing is invalid.

x402 결제 페이로드를 구문 분석하거나 검증할 수 없습니다. 수정하지 않고 402 Payment Required 응답에서 판매자의 x402 페이로드를 수신한 paymentInput.cryptoX402 그대로 로 복사합니다.

Payment instrument network is required

결제 수단은 네트워크를 지정하지 않습니다. 판매자의 결제 페이로드와 일치하는 네트워크로 결제 수단을 생성합니다.

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

결제 수단의 네트워크가 페이로드의 네트워크와 일치하지 않습니다. 네트워크가 판매자의 결제 요청과 일치하는 결제 수단을 사용합니다.

Payment currency is required

페이로드는 통화를 지정하지 않습니다. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

페이로드는 지원되지 않는 통화를 요청합니다. 지원되는 통화를 요청하는 판매자 엔드포인트를 사용합니다.

Payment amount is required

페이로드는 금액을 지정하지 않습니다. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

페이로드 양수가 아닙니다. 판매자의 페이로드를 축어적으로 전달합니다. 금액을 수정하지 마십시오.

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

페이로드 금액이 최대 허용 값을 초과합니다. 금액이 허용된 범위 내에 있는 판매자 엔드포인트를 사용합니다.

Payment asset is required

페이로드는 자산을 지정하지 않습니다. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

페이로드 자산 주소가 네트워크의 유효한 주소가 아닙니다. 판매자의 페이로드를 축어적으로 전달합니다. 자산 주소를 수정하지 마십시오.

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

페이로드는 네트워크에 대한 정식 USDC 이외의 토큰을 요청합니다. 정식 USDC를 요청하는 판매자 엔드포인트를 사용하고 결제 수단의 네트워크가 페이로드와 일치하는지 확인합니다.

Payment scheme is required

페이로드는 체계를 지정하지 않습니다. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

Payment scheme not supported. Supported scheme: {scheme}

페이로드는 지원되지 않는 체계를 요청합니다. AgentCore 결제는 exact 및 upto 체계를 지원합니다. x402 결제 요청 결제를 참조하세요.

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

이 upto 체계에는 x402 프로토콜 버전 2가 필요합니다. 2에서 version를 로 설정paymentInput.cryptoX402하거나 버전 2를 지원하는 판매자 엔드포인트를 사용합니다.

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

이 upto 체계는 EVM 네트워크에서만 지원됩니다. upto EVM 네트워크에서 판매자 엔드포인트를 스키마에 사용합니다.

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

이외의 체계에 permit2AllowanceLimit 대해를 설정합니다upto. upto 스키마permit2AllowanceLimit에 대해서만를 설정합니다. 최대 결제에 대한 Permit2 허용량을 참조하세요.

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

permit2AllowanceLimit 값은 양의 정수가 아닙니다. 자산의 최소 액면가에 허용량을 양의 정수로 제공합니다. 예를 들어 1000000는 소수점 6자리로 1 USDC를 부여하고 115792089237316195423570985008687907853269984665640564039457584007913129639935 (최대 uint256 값)은 무제한 허용량을 부여합니다.

결제 공급자가 Permit2 허용량 거래를 거부했습니다.

가 upto 결제를 위해 approve 트랜잭션을 ProcessPayment브로드캐스트할 때 Wallet 공급자는 이를 거부할 수 있습니다. 예를 들어, 위임된 서명이 부여되지 않았거나 동일한 Wallet의 이전 트랜잭션이 아직 확인되지 않은 경우 공급자는 이를 거부할 수 있습니다. 이 문제를 해결하려면:

Payment payTo address is required

페이로드는 payTo 주소를 지정하지 않습니다. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

페이로드 payTo 주소가 네트워크의 유효한 주소가 아닙니다. 판매자의 페이로드를 축어적으로 전달합니다. payTo 주소를 수정하지 마십시오.

Payment maxTimeoutSeconds is required

페이로드는를 지정하지 않습니다maxTimeoutSeconds. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

Payment maxTimeoutSeconds must be positive. Received: {value}

페이로드 maxTimeoutSeconds 값이 양수가 아닙니다. 판매자의 페이로드를 축어적으로 전달합니다. 값을 수정하지 마십시오.

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

페이로드 maxTimeoutSeconds 값이 최대 허용 값을 초과합니다. 제한 시간이 허용된 범위 내에 있는 판매자 엔드포인트를 사용합니다.

Payment feePayer is required for SVM payments

Solana(SVM) 결제에 대한 페이로드는를 지정하지 않습니다feePayer. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

Payment extra field is required

페이로드에는 필수 extra 필드가 포함되지 않습니다. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

Payment extra.name is required for EVM payments

EVM 결제에 대한 페이로드에는가 포함되지 않습니다extra.name. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

Payment extra.version is required for EVM payments

EVM 결제에 대한 페이로드에는가 포함되지 않습니다extra.version. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

Payment extra.facilitatorAddress is required for the upto scheme

upto 스키마 페이로드에는가 포함되지 않습니다extra.facilitatorAddress. 판매자의 페이로드를 축어적으로 전달합니다. 오류가 지속되면 판매자의 페이로드 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

페이로드extra.facilitatorAddress가 네트워크의 유효한 주소가 아닙니다. 판매자의 페이로드를 축어적으로 전달합니다. 주소를 수정하지 마십시오.

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

wwwAuthenticateHeaders 필드에 정확히 하나의 헤더를 제공합니다. 판매자의 WWW-Authenticate: Payment 챌린지를 그대로 복사합니다. 헤더를 여러 개 보내지 마세요.

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

전달된 헤더는 Payment 문제가 아닙니다. 스키마를 수정하지 않고 판매자의 402 Payment Required 응답에서 WWW-Authenticate 헤더를 전달합니다.

MPP challenge is missing required field: {field}

챌린지에 필수 필드가 누락되었습니다. evm 메서드의 경우 methodDetails.chainId 및 realm가 모두 필요합니다. 전달하기 전에 판매자의 챌린지에 명명된 필드가 포함되어 있는지 확인합니다.

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

챌린지 request 값이 유효한 base64url이 아닙니다. 판매자가 반환한 그대로 챌린지를 전달합니다. 값을 디코딩, 다시 인코딩 또는 수정하지 마십시오.

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

디코딩된 챌린지가 유효한 JSONrequest이 아닙니다. 챌린지를 축어적으로 전달합니다. 오류가 지속되면 판매자의 챌린지 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

챌린지가 id 너무 깁니다. 수정되지 않은 상태로 챌린지를 전달합니다. 오류가 지속되면 판매자의 챌린지 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

챌린지methodDetails.chainId의는 JSON 정수여야 합니다. 챌린지를 축약적으로 전달합니다. 값을 따옴표로 묶거나 다시 포맷하지 마십시오.

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

챌린지 request JSON에는 중복 키가 포함되어 있습니다. 챌린지를 축어적으로 전달합니다. 오류가 지속되면 판매자의 챌린지 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

WWW-Authenticate 헤더에는 중복 파라미터가 포함되어 있습니다. 헤더를 축어적으로 전달합니다. 오류가 지속되면 판매자의 챌린지 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

챌린지 필드에는 허용되지 않는 제어 문자가 포함되어 있습니다. 챌린지를 축어적으로 전달합니다. 오류가 지속되면 판매자의 챌린지 형식이 잘못된 것입니다. 판매자에게 문의하십시오.

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

챌린지는 지원되지 않는 의도를 요청합니다. AgentCore 결제는 MPP의 charge 의도만 지원합니다.

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

챌린지는 지원되지 않는 결제 방법을 요청합니다. AgentCore 결제는 MPP에 대해 evmtempo, 및 solana 메서드만 지원합니다.

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

챌린지는 풀 모드를 제공하지 않습니다. AgentCore 결제는 MPP에 대한 풀 모드만 지원합니다.

MPP version is required.

에 version 필드를 입력합니다paymentInput.mpp.

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

챌린지는 네트워크에 대한 정식 USDC 이외의 토큰을 요청합니다. 표준 USDC를 요청하는 챌린지를 사용합니다. 결제 수단의 네트워크가 챌린지 방법과 일치하는지 확인합니다.

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.

판매자는이 챌린지에 대한 가스 요금을 후원하지 않습니다. 구매자의 지갑에서 가스를 지불paymentInput.mpp하도록 승인하거나 판매자가 요금을 후원하는 챌린지를 얻도록 buyerPaysGasFees=true에 설정합니다. 이는 판매자가 요금을 후원하지 않는 tempo 메서드에 필요합니다.

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

챌린지가 수명이 짧고 만료되었습니다. 유료 리소스를 다시 요청하여 새로운 챌린지를 가져온 다음 다시 시도하세요. 만료된 챌린지에는 예산이 사용되지 않습니다.

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

Solana 챌린지는 지원되지 않는 네트워크를 요청합니다. AgentCore 결제는 Solana MPP 요금에 devnet 대해 mainnet 및 만 지원합니다.

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

Solana 챌린지는 클라이언트 지불 요금을 요청합니다. solana 메서드는 현재 서버 후원 요금만 지원합니다. 판매자가 요금을 후원하는 챌린지를 사용합니다.

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

Coinbase CDP 결제 수단에는 solana 메서드가 지원되지 않습니다. Solana MPP 요금에 Stripe(Privy) 결제 수단을 사용합니다. 결제 처리의 각 방법에 대한 공급자 지원을 참조하세요.

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

구매자의 지갑에 결제 금액과 네트워크(가스) 요금을 모두 충당할 만큼 잔액이 충분하지 않습니다. 추가 USDC로 Wallet에 자금을 지원합니다. Wallet에 자금 조달 및 에이전트 권한 부여를 참조하세요.

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

계정에 대해 MPP 결제 처리가 활성화되지 않았습니다. 액세스를 요청하려면 AWS Support에 문의하세요.

Failed to build MPP payment credential: {reason}

서비스가 챌린지에서 결제 자격 증명을 빌드할 수 없습니다. 챌린지를 축어적으로 전달했는지 확인합니다. 오류가 지속되면 x-amzn-requestid 응답 헤더의 요청 ID로 AWS Support에 문의하세요.