# AgentCore 결제 문제 해결
<a name="payments-troubleshooting"></a>

이 섹션에서는 AWS Amazon Bedrock AgentCore 결제를 사용할 때 발생하는 일반적인 오류에 대한 솔루션을 제공합니다.

## 유효성 검사 오류
<a name="payments-troubleshooting-validation"></a>

결제 리소스를 생성하거나 업데이트할 때 서비스는를 반환합니다`ValidationException`. 다음 표에는 일반적인 검증 오류와 해결 방법이 나와 있습니다.


| 오류 메시지 | 해결 방법 | 
| --- | --- | 
|  `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`. 자격 [증명 공급자 생성을 사용하여 먼저 하나를 생성합니다](resource-providers.md). | 
|  `Connector type '{type}' does not match the provided credentialProviderConfiguration`  | 자격 증명 공급자 구성 변형은 커넥터 유형과 일치해야 합니다. 예를 들어 `CoinbaseCDP` 커넥터에는가 아닌 `coinbaseCDP` 구성이 필요합니다`stripePrivy`. | 

필드 이름 지정 제약 조건도 적용됩니다.
+ 결제 관리자 이름은 문자로 시작해야 하며 영숫자(최대 48자)만 포함해야 합니다.
+ 결제 커넥터 이름은 동일한 규칙을 따르지만 밑줄도 허용합니다.
+ 설명은 영숫자와 공백(최대 4096자)을 허용합니다.

## 권한 오류
<a name="payments-troubleshooting-permissions"></a>


| 오류 메시지 | 해결 방법 | 
| --- | --- | 
|  `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`로 허용해야 합니다. | 

## 리소스를 찾을 수 없음 오류
<a name="payments-troubleshooting-not-found"></a>


| 오류 메시지 | 해결 방법 | 
| --- | --- | 
|  `Payment manager not found: {managerId}`  | 지정된 결제 관리자가 존재하지 않습니다. 를 호출하여 ID를 확인합니다`ListPaymentManagers`. | 
|  `Payment connector not found: connectorId={connectorId}, managerId={managerId}`  | 지정된 관리자 아래에 지정된 커넥터가 없습니다. IDs를 모두 확인합니다`ListPaymentConnectors`. | 
| 에서 리소스를 찾을 수 없음 `CreatePaymentConnector`  | 상위 결제 관리자가 존재하지 않습니다. 먼저 결제 관리자를 생성합니다. | 

## 충돌 오류
<a name="payments-troubleshooting-conflict"></a>

서비스는 `ConflictException` 두 요청이 동시에 동일한 리소스를 수정하거나 이미 존재하는 리소스를 생성할 때를 반환합니다. 요청을 다시 시도하세요. 생성 및 업데이트 작업은 안전한 재시도를 `clientToken` 위해를 지원합니다.

## 서비스 할당량 오류
<a name="payments-troubleshooting-quota"></a>

계정의 최대 결제 관리자 또는 커넥터 수에 도달`"{limitType} limit exceeded for account {accountId}"`하면 서비스가를 반환합니다. 미사용 리소스를 삭제하거나 AWS Support에 문의하여 한도 증가를 요청하세요.

## 제한 오류
<a name="payments-troubleshooting-throttling"></a>

요청 속도가 허용 한도를 초과`"Rate exceeded"`하면 서비스가를 반환합니다. 재시도 로직에서 지터를 사용하여 지수 백오프를 구현합니다. 한도에 지속적으로 도달하면 AWS Support에 문의하십시오.

## 결제 처리 오류
<a name="payments-troubleshooting-processing"></a>

외부 결제 공급자가 서명 요청을 거부하면 서비스는 `AccessDeniedException` 또는를 반환합니다`ValidationException`. 다음 표에는 일반적인 오류와 해결 방법이 나와 있습니다.


| 오류 메시지 | 해결 방법 | 
| --- | --- | 
|  `Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.`  | 에이전트가 사용자를 대신하여 트랜잭션에 서명하도록 허용하는 위임 권한을 부여하지 않았거나 이전에 트랜잭션을 취소했습니다. 이 문제를 해결하려면:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />위임 권한 부여 흐름을 처리하는 프런트엔드 구현에 대한 자세한 내용은 GitHub 웹 사이트의 [Coinbase AgentCore 템플릿을](https://github.com/coinbase/cdp-agentcore-template) 참조하세요. Wallet 자금 조달에 대한 자세한 내용은 [Wallet 자금 조달을 참조하세요](payments-how-it-works.md#payments-how-it-works-funding-wallet). | 
|  `Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.`  | Coinbase 개발자 플랫폼 프로젝트에 위임된 서명이 구성되어 있지 않습니다. 이 문제를 해결하려면:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />에이전트가 사용자를 대신하여 트랜잭션에 서명하려면 먼저이 단계를 완료해야 합니다. | 
|  `Privy credentials are invalid. Please verify the credential configuration.`  | 자격 증명 공급자에 유효하지 않거나 만료된 Privy wallet 권한 부여 키가 있습니다. 이 문제를 해결하려면:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />자격 증명 구성에 대한 자세한 내용은 GitHub 웹 사이트의 [Privy AgentCore SDK](https://github.com/privy-io/aws-agentcore-sdk)를 참조하세요. | 

## 서버 오류
<a name="payments-troubleshooting-server"></a>

서비스는 내부 오류`"Something went wrong in processing your request"`에 대해를 반환합니다. 잠시 후 요청을 다시 시도합니다. 오류가 지속되면 `x-amzn-requestid` 응답 헤더의 요청 ID로 AWS Support에 문의하세요.