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

支払いコネクタを作成または更新するときに、少なくとも 1 つの認証情報プロバイダー設定を指定します。

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 Marketplace サブスクリプションがありません。解決するには:

詳細については、「Subscribe to Coinbase Wallets for AgentCore Payments in AWS Marketplace」を参照してください。

コネクタが にスタックする 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 テンプレートを参照してください。ウォレットへの資金供給の詳細については、「ウォレットへの資金供給」を参照してください。

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.

認証情報プロバイダーに無効または期限切れのプライベートウォレット認可キーがあります。解決するには:

認証情報設定の詳細については、GitHub ウェブサイトの Privy AgentCore SDK を参照してください。

SubscriptionRequiredException (HTTP 403)

アカウントに Coinbase のアクティブな AWS Marketplace サブスクリプションがありません。Coinbase ウォレットに対する支払いを処理するには、アクティブなサブスクリプションが必要であるため、サブスクリプションが一度も作成されなかったり、後でキャンセルされたりすると、このエラーが発生する可能性があります。解決するには:

詳細については、「Subscribe to Coinbase Wallets for AgentCore Payments in AWS Marketplace」およびAWS 「 Marketplace subscription errors」を参照してください。

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 が必要です。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 値は正の整数ではありません。アセットの最小額面金額に、許容値を正の整数として指定します。たとえば、 は小数点以下 6 桁で 1 USDC 1000000を付与し、 115792089237316195423570985008687907853269984665640564039457584007913129639935 (uint256最大値) は無制限の許容量を付与します。

支払いプロバイダーが Permit2 手当トランザクションを拒否しました。

がupto支払いのためにapproveトランザクションをProcessPaymentブロードキャストすると、ウォレットプロバイダーはトランザクションを拒否できます。たとえば、委任署名が付与されていない場合や、同じウォレットからの以前のトランザクションがまだ確認されていない場合、プロバイダーはこれを拒否できます。解決するには:

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 フィールドに 1 つのヘッダーのみを指定します。マーチャントの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}

チャレンジ JSON request には重複するキーが含まれています。チャレンジを逐語的に転送します。エラーが解決しない場合は、マーチャントのチャレンジの形式が正しくありません。マーチャントにお問い合わせください。

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 支払いはevm、MPP の 、tempo、および 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.

販売者は、このチャレンジのガス料金をスポンサーしません。buyerPaysGasFees=true で設定paymentInput.mppして、購入者のウォレットからのガスの支払いを承認するか、販売者が料金をスポンサーするチャレンジを取得します。これは、販売者が料金をスポンサーしない場合の 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.

solana メソッドは、Coinbase CDP 支払い手段ではサポートされていません。Solana MPP 料金には Stripe (Privy) 支払い手段を使用します。各方法のプロバイダーサポートについては、「支払いの処理」を参照してください。

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レスポンスヘッダーのリクエスト ID を使用して AWS サポートにお問い合わせください。