Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pemecahan AgentCore masalah pembayaran
Bagian ini memberikan solusi untuk kesalahan umum saat menggunakan AgentCore pembayaran AWS Amazon Bedrock.
Kesalahan validasi
Saat membuat atau memperbarui sumber daya pembayaran, layanan mengembalikan aValidationException. Tabel berikut mencantumkan kesalahan validasi umum dan resolusinya.
| Pesan kesalahan | Resolusi |
|---|---|
|
|
|
|
|
ID akun di |
|
|
Itu tidak |
|
|
Berikan setidaknya satu konfigurasi penyedia kredensia saat membuat atau memperbarui konektor pembayaran. |
|
|
Setiap konfigurasi penyedia kredensi harus menyertakan a |
|
|
Varian konfigurasi penyedia kredensi harus sesuai dengan jenis konektor. Misalnya, |
Batasan 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 alfanumerik dan spasi (maks 4096 karakter).
Kesalahan izin
| Pesan kesalahan | Resolusi |
|---|---|
|
|
Akun Anda telah dibatasi. Hubungi AWS Dukungan untuk menyelesaikannya. |
|
|
Akun Anda dalam keadaan akses terbatas. Operasi baca dan daftar diperbolehkan, tetapi operasi pembuatan dan perbarui dibatasi hingga pembatasan diselesaikan. |
|
Kegagalan otorisasi IAM SIGv4 |
Pastikan kepala pemanggil memiliki |
|
PassRole kegagalan |
Saat memberikan a |
AWS Kesalahan berlangganan pasar
Saat Anda menggunakan Coinbase sebagai penyedia pembayaran, akun Anda harus memiliki langganan aktif ke daftar Coinbase Wallets for Payments di AgentCore AWS Market place. Jika langganan hilang, layanan mengembalikan kode status HTTP 403. SubscriptionRequiredException
Kesalahan ini diberlakukan di dua tempat:
-
Saat Anda membuat konektor pembayaran Coinbase dengan
CreatePaymentConnector. -
Saat Anda melakukan operasi dompet Coinbase di bidang data, seperti
CreatePaymentInstrumentatauProcessPayment.
Pengecualian mencakup subscriptionUrl bidang dengan tautan ke daftar AWS Marketplace dan productName bidang yang mengidentifikasi produk yang memerlukan langganan.
| Pesan kesalahan | Resolusi |
|---|---|
|
|
Akun Anda tidak memiliki langganan AWS Marketplace aktif untuk Coinbase. Untuk menyelesaikan:
Untuk informasi selengkapnya, lihat Ber langganan Dompet Coinbase untuk AgentCore Pembayaran di AWS Marketplace. |
Buat kesalahan otorisasi dengan cepat
Quick create memungkinkan Anda mengatur konektor pembayaran Coinbase tanpa mengelola kredenSIAL sendiri. Saat Anda meneleponCreatePaymentConnector, layanan mengembalikanauthorizationUrl. Buka URL (atau berikan kepada pengguna aplikasi Anda) untuk menyelesaikan otorisasi Coinbase. Selama aliran ini, konektor bergerak melalui Quick-create-specific status berikut:
-
PENDING_AUTHENTICATION— Konektor sedang menunggu Anda (atau pengguna aplikasi Anda) untuk menyelesaikan otorisasi Coinbase. -
PROVISIONING- Otorisasi selesai dan layanan menyediakan konektor. -
AUTHENTICATION_EXPIRED— KedauthorizationUrlaluwarsa sebelum otorisasi selesai. -
AUTHENTICATION_FAILEDOtorisasi Coinbase tidak berhasil.
Tabel berikut mencantumkan masalah otorisasi pembuatan cepat yang umum dan resolusinya.
| Status konektor | Resolusi |
|---|---|
|
Konektor macet |
Otorisasi pembuatan cepat belum selesai. Untuk menyelesaikan:
|
|
Konektor masuk |
Ked
|
Kesalahan sumber daya tidak ditemukan
| Pesan kesalahan | Resolusi |
|---|---|
|
|
Manajer pembayaran yang ditentukan tidak ada. Verifikasi ID dengan menelepon |
|
|
Konektor yang ditentukan tidak ada di bawah manajer yang diberikan. Verifikasi kedua ID menggunakan |
|
Sumber daya tidak ditemukan selama |
Manajer pembayaran induk tidak ada. Buat manajer pembayaran terlebih dahulu. |
Kesalahan konflik
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. Buat dan perbarui dukungan operasi a clientToken untuk percobaan ulang yang aman.
Kesalahan kuota layanan
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 Dukungan untuk meminta kenaikan batas.
Kesalahan throttling
Layanan kembali "Rate exceeded" ketika tingkat permintaan melebihi batas yang diizinkan. Terapkan backoff eksponensial dengan jitter dalam logika coba ulang Anda. Jika Anda secara konsisten mencapai batas, hubungi AWS Dukungan.
Kesalahan pemrosesan pembayaran
Jika penyedia pembayaran eksternal menolak permintaan penandatanganan, layanan mengembalikan AccessDeniedException atauValidationException. Pemrosesan pembayaran juga gagal SubscriptionRequiredException jika akun Anda tidak memiliki langganan AWS Marketplace aktif untuk Coinbase. Tabel berikut mencantumkan kesalahan umum dan resolusinya.
| Pesan kesalahan | Resolusi |
|---|---|
|
|
Anda belum memberikan izin delegasi yang memungkinkan agen menandatangani transaksi atas nama Anda, atau sebelumnya Anda mencabutnya. Untuk menyelesaikan:
Untuk informasi lebih lanjut tentang implementasi frontend yang menangani aliran hibah delegasi, lihat AgentCore template Coinbase |
|
|
Proyek Platform Pengembang Coinbase Anda tidak memiliki penandatanganan delegasi yang dikonfigurasi. Untuk menyelesaikan:
Anda harus menyelesaikan langkah ini sebelum agen Anda dapat menandatangani transaksi atas nama pengguna. |
|
|
Penyedia kredensi Anda memiliki kunci otorisasi dompet Privy yang tidak valid atau kedaluwarsa. Untuk menyelesaikan:
Untuk informasi selengkapnya tentang konfigurasi kredensi, lihat Privy AgentCore SDK |
|
|
Akun Anda tidak memiliki langganan AWS Marketplace aktif untuk Coinbase. Memproses pembayaran terhadap dompet Coinbase memerlukan langganan aktif, sehingga kesalahan ini dapat terjadi jika langganan tidak pernah dibuat atau kemudian dibatalkan. Untuk menyelesaikan:
Untuk informasi selengkapnya, lihat Ber langganan Dompet Coinbase untuk AgentCore Pembayaran di AWS Marketplace dan Kesalahan berlangganan AWS Marketplace. |
kesalahan permintaan pembayaran x402
Saat Anda memproses pembayaran dengan protokol x402, layanan memvalidasi payload pembayaran yang Anda teruskan paymentInput.cryptoX402 sebelum menahan anggaran atau tanda tangan. Jika payload salah bentuk atau tidak didukung, layanan mengembalikan ValidationException a dan tidak menghabiskan anggaran. Tabel berikut mencantumkan kesalahan permintaan pembayaran x402 umum dan resolusinya. Beberapa baris menjelaskan kegagalan runtime atau penyelesaian, seperti transaksi tunjangan Permit2 yang ditolak, yang dapat terjadi setelah penandatanganan dimulai, bukan selama validasi pra-penandatanganan.
| Pesan kesalahan | Resolusi |
|---|---|
|
|
Payload pembayaran x402 tidak dapat diurai atau divalidasi. Salin payload x402 merchant dari |
|
|
Instrumen pembayaran tidak menentukan jaringan. Buat instrumen pembayaran dengan jaringan yang cocok dengan payload pembayaran merchant. |
|
|
Jaringan instrumen pembayaran tidak cocok dengan jaringan dalam payload. Gunakan instrumen pembayaran yang jaringannya cocok dengan permintaan pembayaran merchant. |
|
|
Payload tidak menentukan mata uang. Teruskan payload pedagang kata demi kata. Jika kesalahan berlanjut, muatan pedagang cacat; hubungi pedagang. |
|
|
Payload meminta mata uang yang tidak didukung. Gunakan titik akhir pedagang yang meminta mata uang yang didukung. |
|
|
Payload tidak menentukan jumlah. Teruskan payload pedagang kata demi kata. Jika kesalahan berlanjut, muatan pedagang cacat; hubungi pedagang. |
|
|
Jumlah payload bukanlah angka positif. Teruskan payload merchant kata demi kata; jangan mengubah jumlahnya. |
|
|
Jumlah payload berada di atas nilai maksimum yang diizinkan. Gunakan titik akhir pedagang yang jumlahnya berada dalam kisaran yang diizinkan. |
|
|
Payload tidak menentukan aset. Teruskan payload pedagang kata demi kata. Jika kesalahan berlanjut, muatan pedagang cacat; hubungi pedagang. |
|
|
Alamat aset payload bukanlah alamat yang valid untuk jaringan. Teruskan payload merchant kata demi kata; jangan mengubah alamat aset. |
|
|
Payload meminta token selain USDC kanonik untuk jaringan. Gunakan titik akhir pedagang yang meminta USDC kanonik, dan verifikasi bahwa jaringan instrumen pembayaran cocok dengan payload. |
|
|
Payload tidak menentukan skema. Teruskan payload pedagang kata demi kata. Jika kesalahan berlanjut, muatan pedagang cacat; hubungi pedagang. |
|
|
Payload meminta skema yang tidak didukung. AgentCore pembayaran mendukung |
|
|
S |
|
|
S |
|
|
Anda |
|
|
Nil |
|
Penyedia pembayaran menolak transaksi tunjangan Permit2. |
Saat
|
|
|
Payload tidak menentukan |
|
|
Alamat payload bukan |
|
|
Payload tidak menentukan |
|
|
Nilai payload |
|
|
Nilai payload |
|
|
Payload untuk pembayaran Solana (SVM) tidak ditentukan. |
|
|
Payload tidak menyertakan |
|
|
Payload untuk pembayaran EVM tidak termasuk. |
|
|
Payload untuk pembayaran EVM tidak termasuk. |
|
|
S |
|
|
Payload |
Kesalahan tantangan MPP
Saat Anda memproses pembayaran dengan Protokol Pembayaran Mesin (MPP), layanan memvalidasi WWW-Authenticate: Payment tantangan yang Anda teruskan. paymentInput.mpp Ini memvalidasi tantangan sebelum memegang anggaran atau tanda. Jika tantangan salah bentuk, tidak didukung, atau kedaluwarsa, layanan mengembalikan a ValidationException dan tidak menghabiskan anggaran. Tabel berikut mencantumkan kesalahan tantangan MPP umum dan resolusinya. Beberapa baris menggambarkan kesalahan runtime atau akses, seperti saldo dompet yang tidak mencukupi, akses MPP tidak diaktifkan, atau kegagalan pembuatan kredensi, bukan kesalahan validasi pra-penandatanganan.
| Pesan kesalahan | Resolusi |
|---|---|
|
|
Berikan |
|
|
Header yang diteruskan bukanlah |
|
|
Tantangannya tidak memiliki bidang wajib. Untuk |
|
|
|
|
|
Tantangan yang didekode |
|
|
Tant |
|
|
|
|
|
|
|
|
|
|
|
Bidang tantangan berisi karakter kontrol yang tidak diizinkan. Teruskan tantangan kata demi kata. Jika kesalahan berlanjut, tantangan pedagang salah bentuk; hubungi pedagang. |
|
|
Tantangan meminta niat yang tidak didukung. AgentCore pembayaran hanya mendukung |
|
|
Tantangan meminta metode pembayaran yang tidak didukung. AgentCore pembayaran hanya mendukung |
|
|
Tantangannya tidak menawarkan mode tarik. AgentCore pembayaran hanya mendukung mode tarik untuk MPP. |
|
|
Berikan |
|
|
Tantangan meminta token selain USDC kanonik untuk jaringan. Gunakan tantangan yang meminta USDC kanonik. Pastikan jaringan instrumen pembayaran cocok dengan metode tantangan. |
|
|
Penjual tidak mensponsori biaya gas untuk tantangan ini. Ber |
|
|
Tantangannya berumur pendek dan telah kedaluwarsa. Minta sumber daya berbayar lagi untuk mendapatkan tantangan baru, lalu coba lagi. Tidak ada anggaran yang digunakan untuk tantangan yang kedaluwarsa. |
|
|
Tantangan Solana meminta jaringan yang tidak didukung. AgentCore pembayaran hanya mendukung |
|
|
Tantangan Solana meminta biaya yang dibayar klien. |
|
|
|
|
|
Dompet pembeli tidak memiliki saldo yang cukup untuk menutupi jumlah pembayaran dan biaya jaringan (gas). Danai dompet dengan USDC tambahan. Lihat Mendanai dompet dan memberikan izin agen. |
|
|
Pemrosesan pembayaran MPP tidak diaktifkan untuk akun Anda. Hubun AWS gi Dukungan untuk meminta akses. |
|
|
Layanan tidak dapat membangun kredenSIAL pembayaran dari tantangan. Pastikan Anda meneruskan tantangan kata demi kata. Jika kesalahan berlanjut, hubungi AWS Dukungan dengan ID permintaan dari header |
Kesalahan server
Layanan kembali "Something went wrong in processing your request" untuk kesalahan internal. Coba kembali permintaan setelah penundaan singkat. Jika kesalahan berlanjut, hubungi AWS Dukungan dengan ID permintaan dari header x-amzn-requestid respons.