# Memecahkan masalah pembayaran AgentCore
<a name="payments-troubleshooting"></a>

Bagian ini memberikan solusi untuk kesalahan umum saat menggunakan AgentCore pembayaran AWS Amazon Bedrock.

## Kesalahan validasi
<a name="payments-troubleshooting-validation"></a>

Saat membuat atau memperbarui sumber daya pembayaran, layanan mengembalikan file`ValidationException`. Tabel berikut mencantumkan kesalahan validasi umum dan resolusinya.


| Pesan kesalahan | Resolusi | 
| --- | --- | 
|  `roleArn must contain a valid account ID`  | `roleArn`Harus menjadi ARN peran IAM yang valid dengan ID akun 12 digit. Verifikasi formatnya:`arn:aws:iam::<accountId>:role/<roleName>`. | 
|  `roleArn must belong to your account`  | ID akun `roleArn` harus sesuai dengan akun pemanggil. Cross-account peran tidak didukung. | 
|  `Invalid role ARN: {roleArn}`  | Itu tidak `roleArn` bisa diurai. Verifikasi format ARN. | 
|  `credentialProviderConfigurations list cannot be empty`  | Berikan setidaknya satu konfigurasi penyedia kredensi saat membuat atau memperbarui konektor pembayaran. | 
|  `credentialProviderArn is required but not found in the request`  | Setiap konfigurasi penyedia kredensi harus menyertakan file. `credentialProviderArn` Buat yang pertama menggunakan [Create a Credential Provider](resource-providers.md). | 
|  `Connector type '{type}' does not match the provided credentialProviderConfiguration`  | Varian konfigurasi penyedia kredensi harus sesuai dengan jenis konektor. Misalnya, `CoinbaseCDP` konektor memerlukan `coinbaseCDP` konfigurasi, bukan`stripePrivy`. | 

Kendala penamaan bidang juga diberlakukan:
+ Nama manajer pembayaran harus dimulai dengan huruf dan hanya berisi karakter alfanumerik (maks 48 karakter).
+ Nama konektor pembayaran mengikuti aturan yang sama tetapi juga memungkinkan garis bawah.
+ Deskripsi memungkinkan karakter dan spasi alfanumerik (maks 4096 karakter).

## Kesalahan izin
<a name="payments-troubleshooting-permissions"></a>


| Pesan kesalahan | Resolusi | 
| --- | --- | 
|  `Access denied due to account security restrictions. Contact AWS Support for assistance.`  | Akun Anda telah dibatasi. Hubungi AWS Support untuk menyelesaikannya. | 
|  `Access denied for {CREATE\|UPDATE} due to account security restrictions. Contact AWS Support for assistance.`  | Akun Anda dalam status akses terbatas. Operasi baca dan daftar diizinkan, tetapi operasi buat dan perbarui dibatasi hingga pembatasan diselesaikan. | 
| Kegagalan otorisasi IAM SiGv4 | Pastikan kepala sekolah panggilan memiliki `bedrock-agentcore:` izin yang sesuai. Layanan ini menggunakan penandatanganan SiGv4 dengan nama `bedrock-agentcore` penandatanganan. | 
| PassRole kegagalan | Saat memberikan a`roleArn`, penelepon harus memiliki `iam:PassRole` izin untuk peran tersebut. Kebijakan kepercayaan peran harus memungkinkan `bedrock-agentcore.amazonaws.com` sebagai kepala layanan. | 

## Kesalahan sumber daya tidak ditemukan
<a name="payments-troubleshooting-not-found"></a>


| Pesan kesalahan | Resolusi | 
| --- | --- | 
|  `Payment manager not found: {managerId}`  | Manajer pembayaran yang ditentukan tidak ada. Verifikasi ID dengan menelepon`ListPaymentManagers`. | 
|  `Payment connector not found: connectorId={connectorId}, managerId={managerId}`  | Konektor yang ditentukan tidak ada di bawah manajer yang diberikan. Verifikasi kedua ID menggunakan`ListPaymentConnectors`. | 
| Sumber daya tidak ditemukan selama `CreatePaymentConnector`  | Manajer pembayaran induk tidak ada. Buat manajer pembayaran terlebih dahulu. | 

## Kesalahan konflik
<a name="payments-troubleshooting-conflict"></a>

Layanan mengembalikan `ConflictException` ketika dua permintaan memodifikasi sumber daya yang sama pada saat yang sama, atau saat membuat sumber daya yang sudah ada. Coba lagi permintaannya. Membuat dan memperbarui operasi mendukung a `clientToken` untuk percobaan ulang yang aman.

## Kesalahan kuota layanan
<a name="payments-troubleshooting-quota"></a>

Layanan kembali `"{limitType} limit exceeded for account {accountId}"` ketika Anda mencapai jumlah maksimum manajer pembayaran atau konektor untuk akun Anda. Hapus sumber daya yang tidak digunakan atau hubungi AWS Support untuk meminta peningkatan batas.

## Kesalahan throttling
<a name="payments-troubleshooting-throttling"></a>

Layanan kembali `"Rate exceeded"` ketika tingkat permintaan melebihi batas yang diizinkan. Terapkan backoff eksponensial dengan jitter dalam logika coba lagi Anda. Jika Anda secara konsisten mencapai batas, hubungi AWS Support.

## Kesalahan pemrosesan pembayaran
<a name="payments-troubleshooting-processing"></a>

Jika penyedia pembayaran eksternal menolak permintaan penandatanganan, layanan mengembalikan `AccessDeniedException` atau`ValidationException`. Tabel berikut mencantumkan kesalahan umum dan resolusinya.


| Pesan kesalahan | Resolusi | 
| --- | --- | 
|  `Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.`  | Anda belum memberikan izin delegasi yang memungkinkan agen Anda untuk menandatangani transaksi atas nama Anda, atau Anda sebelumnya mencaatnya. Untuk menyelesaikan:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />Untuk informasi lebih lanjut tentang implementasi frontend yang menangani alur hibah delegasi, lihat [ AgentCore template Coinbase](https://github.com/coinbase/cdp-agentcore-template) di situs web. GitHub Untuk informasi selengkapnya tentang mendanai dompet, lihat [Mendanai dompet](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.`  | Proyek Platform Pengembang Coinbase Anda tidak memiliki penandatanganan yang didelegasikan yang dikonfigurasi. Untuk menyelesaikan:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />Anda harus menyelesaikan langkah ini sebelum agen Anda dapat menandatangani transaksi atas nama pengguna. | 
|  `Privy credentials are invalid. Please verify the credential configuration.`  | Penyedia kredensi Anda memiliki kunci otorisasi dompet Privy yang tidak valid atau kedaluwarsa. Untuk menyelesaikan:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)<br />Untuk informasi selengkapnya tentang konfigurasi kredensi, lihat [Privy AgentCore SDK di situs web](https://github.com/privy-io/aws-agentcore-sdk). GitHub  | 

## Kesalahan server
<a name="payments-troubleshooting-server"></a>

Layanan kembali `"Something went wrong in processing your request"` untuk kesalahan internal. Coba lagi permintaan setelah penundaan singkat. Jika kesalahan berlanjut, hubungi AWS Support dengan ID permintaan dari header `x-amzn-requestid` respons.