AgentCore 付款疑难解答

roleArn must contain a valid account ID

roleArn必须是具有 12 位数账户 ID 的有效 IAM 角色 ARN。验证格式:arn:aws:iam::<accountId>:role/<roleName>.

roleArn must belong to your account

中的账户 ID roleArn 必须与来电者的账户相匹配。 Cross-account 不支持角色。

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 支持部门解决问题。

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 市场订阅。要解决这个问题，请执行以下操作：

有关更多信息，请参阅订阅Coinbase钱包以在 AWS 市场上 AgentCore 付款。

连接器卡住了 PENDING_AUTHENTICATION

快速创建授权尚未完成。要解决这个问题，请执行以下操作：

连接器输入 AUTHENTICATION_EXPIRED

过authorizationUrl期，它发生在CreatePaymentConnector退货大约 10 分钟后。要解决这个问题，请执行以下操作：

Payment manager not found: {managerId}

指定的付款管理器不存在。通过致电验证身份ListPaymentManagers。

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

指定的连接器在给定的管理器下不存在。使用验证两个 ID ListPaymentConnectors。

期间未找到资源 CreatePaymentConnector

上级付款管理器不存在。首先创建付款管理器。

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

你没有授予允许你的代理人代表你签署交易的委托权限，或者你之前已经撤销了该权限。要解决这个问题，请执行以下操作：

有关处理委托拨款流的前端实现的更多信息，请参阅网站上的 Coinbase AgentCore 模板。 GitHub 有关为钱包注资的更多信息，请参阅为钱包注资。

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 钱包授权密钥无效或已过期。要解决这个问题，请执行以下操作：

有关凭证配置的更多信息，请参阅网站上的 Privy AgentCore SDK。 GitHub

SubscriptionRequiredException(HTTP 403)

您的账户没有有效的Coinbase AWS 市场订阅。使用Coinbase钱包处理付款需要有效订阅，因此，如果订阅从未创建或后来被取消，则可能会发生此错误。要解决这个问题，请执行以下操作：

有关更多信息，请参阅订阅Coinbase钱包以 AgentCore 应对 AWS 市场中的付款和AWS 市场订阅错误。

X402 Payload for signing is invalid.

无法解析或验证 x402 付款负载。将卖家的 x402 有效载荷从402 Payment Required响应中复制到与收到的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。设置version为 2 inpaymentInput.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。permit2AllowanceLimit仅为该upto方案设置。参见 Permit2 补贴以了解最高付款金额。

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

该permit2AllowanceLimit值不是正整数。以资产最小面额的正整数形式提供补贴。例如，按小数 6 位1000000授予 1 个 USDC，并且115792089237316195423570985008687907853269984665640564039457584007913129639935（最大uint256值）授予无限额度。

支付提供商拒绝了Permit2补贴交易。

当ProcessPayment广播approve交易以进行upto付款时，钱包提供商可以拒绝该交易。例如，如果未授予委托签名，或者来自同一钱包的先前交易尚未得到确认，则提供商可以拒绝。要解决这个问题，请执行以下操作：

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}

解码后的质询request不是有效的 JSON。逐字转发挑战。如果错误仍然存在，则卖家的质询格式不正确；请联系卖家。

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 付款仅mainnet支持 Sol devnet ana MPP 费用。

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方法。使用 Stripe（Privy）支付工具支付 Solana MPP 费用。在 “处理付款” 中查看提供商对每种方式的支持。

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

买家的钱包没有足够的余额来支付付款金额和网络（汽油）费用。使用额外的USDC为钱包注资。请参阅为钱包注资和授予代理权限。

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

您的账户未启用 MPP 付款处理。请联系 AWS 支持部门申请访问权限。

Failed to build MPP payment credential: {reason}

该服务无法通过挑战建立付款凭证。确认您逐字转发了质询。如果错误仍然存在，请使用x-amzn-requestid响应标头中的请求编号与 AWS 支持部门联系。