# Kernkonzepte für AgentCore Zahlungen
## Schlüsselpersonen
Personas, die mit AgentCore Zahlungen interagieren, können von Organisation zu Organisation unterschiedlich sein. Im Folgenden sind die allgemeinen Personas aufgeführt, die in allen Organisationen zu finden sind.
1. **Agentenentwickler**: Agentenentwickler entwickeln KI-Agenten, die Mikrotransaktionszahlungen ausführen, um auf kostenpflichtige APIs, MCP-Server und Webinhalte zuzugreifen. Sie übernehmen administrative Aufgaben wie die Konfiguration von Ausgabenleitplanken, die Überwachung der Zahlungsaktivitäten und die Verwaltung der Richtlinien für Wallet-Anmeldeinformationen. Sie führen einmalig die Einrichtung (Erstellung PaymentManagers und Erstellung PaymentConnectors) der Steuerungsebene durch und integrieren ihren Agentencode in das AgentCore Zahlungs-SDK oder die Datenebenen-APIs, um eine autonome Zahlungsausführung zu ermöglichen.
1. **Endbenutzer**: Endbenutzer interagieren mit dem Agenten, um ein bestimmtes Ziel zu erreichen. Sie können das Agentenguthaben mit kryptobasierten Stablecoins oder herkömmlichen Zahlungsmethoden wie Kreditkarten (begrenzte Verfügbarkeit aufgrund geografischer Einschränkungen), Debitkarten, Apple Pay, Google Pay oder ACH aufladen, sodass Agenten Transaktionen in ihrem Namen ausführen können, mit Ausgabenberechtigungen, konfigurierbaren Ausgabenlimits und vollständiger Transparenz darüber, wie ihr Geld verwendet wird.
1. **Händler**: Händler sind API-Anbieter, Inhaltsanbieter und Dienstanbieter, die ihre Angebote durch Pay-per-Use-Modelle monetarisieren. Sie legen die Preise fest, akzeptieren x402-Zahlungen und liefern den angeforderten Inhalt oder die angeforderte Dienstleistung nach Zahlungsbestätigung.
## Die wichtigsten Konzepte
### PaymentManager
A PaymentManager ist die Ressource auf oberster Ebene, die Sie in Ihrem AWS Konto erstellen, um die Zahlungsvorgänge für Ihre KI-Agenten zu koordinieren. Jede PaymentManager hat einen Namen, eine Autorisierungskonfiguration, die steuert, wie sich Agenten auf der Datenebene (`AWS_IAM`oder`CUSTOM_JWT`) authentifizieren, und eine IAM-Rolle, die der Service zur Laufzeit übernimmt. Wenn Sie eine erstellen PaymentManager, stellt AgentCore Payments eine entsprechende Workload-Identität in Identity bereit. AgentCore Jede PaymentManager hat eine eindeutige Kennung und einen ARN und verwaltet eine oder mehrere PaymentConnectors untergeordnete Ressourcen.
Wie Sie Ihre organisieren, PaymentManagers hängt von Ihren Bedürfnissen ab. Zum Beispiel getrennt PaymentManagers für verschiedene Agentenanwendungen, unterschiedliche Umgebungen (Produktion, Staging, Entwicklung) oder verschiedene Teams innerhalb Ihres Unternehmens.
### PaymentConnector
A PaymentConnector integriert Sie PaymentManager mit einem externen Zahlungsanbieter. Jeder Connector verweist auf einen in AgentCore Identity gespeicherten Anmeldeinformationsanbieter, wodurch sichergestellt wird, dass vertrauliche Anmeldeinformationen wie API-Schlüssel und Wallet-Geheimnisse niemals direkt an die Payments-API weitergegeben werden. Anmeldeinformationen werden in AWS Secrets Manager über AgentCore Identity gespeichert und von ARN referenziert. A PaymentConnector gehört zu genau einem PaymentManager, und ein einzelner PaymentManager kann mehrere Konnektoren haben (z. B. einen für Coinbase und einen anderen für Stripe). AgentCore Payments unterstützt die folgenden Konnektortypen:
1. **[CoinbaseCDP](https://docs.cdp.coinbase.com/wallets/non-custodial-wallets/overview)** — Stellt eine Verbindung zur Coinbase Developer Platform für den Betrieb von Krypto-Wallets her.
1. **[StripePrivy](https://docs.privy.io/wallets/overview/embedded)**— Stellt über die Privy-Wallet-Infrastruktur eine Verbindung zu Stripe her.
### PaymentSession
A PaymentSession ist ein umfassender Zahlungskontext, der die Ausgaben für eine Interaktion mit einem einzelnen Agenten verfolgt. Jede Sitzung hat eine konfigurierbare Ablaufdauer und kann optional Ausgabenlimits (`maxSpendAmount`,`currency`) enthalten, die Zahlungslimits durchsetzen. Wenn die Sitzung abläuft oder das Zahlungslimit erreicht ist, werden weitere Zahlungsanfragen innerhalb dieser Sitzung abgelehnt. Schlägt die Unterzeichnung einer Zahlung nach einem Abzug fehl, wird der Betrag automatisch zurückgenommen.
### PaymentInstrument
A PaymentInstrument steht für eine eingebettete Krypto-Wallet, die ein Agent verwendet, um Händler im Namen eines Benutzers zu bezahlen. Jedes Instrument ist einem bestimmten Blockchain-Netzwerk zugeordnet und hat einen der folgenden Status:`INITIATED`, `ACTIVE``FAILED`, oder`DELETED`. Da dieselbe Wallet-Adresse nicht kettenübergreifend verwendet werden kann, verwenden Entwickler separate Instrumente für jedes unterstützte Netzwerk (z. B. Ethereum und Solana). Der einzige unterstützte Instrumententyp ist`EMBEDDED_CRYPTO_WALLET`.
### PaymentCredentialProvider
A PaymentCredentialProvider ist ein spezialisierter Anbieter von Anmeldeinformationen für AgentCore Identitäten, der für Zahlungsprotokolle mit Kryptowährungen entwickelt wurde. Es speichert herstellerspezifische Anmeldeinformationen (wie Coinbase CDP-API-Schlüssel und Wallet-Secrets oder Privy-App-Anmeldeinformationen und Autorisierungsschlüssel) sicher im Secrets Manager. AWS Zur Laufzeit ruft der Zahlungsdienst Authentifizierungstoken über die Identity Data Plane API ab. AgentCore `GetResourcePaymentToken` Jeder PaymentConnector verwaltet eine 1:1 -Zuordnung mit einem PaymentCredentialProvider.
### x402-Protokoll
Das x402-Protokoll ist ein offener HTTP-native Zahlungsstandard, der den HTTP-402-Statuscode für direkte, programmatische Zahlungen wiederverwendet. Wenn ein Mitarbeiter eine kostenpflichtige Ressource anfordert, antwortet der Händler mit HTTP, `402 Payment Required` einschließlich einer Payload für Zahlungen, die den Betrag, den Empfänger, das Asset und das Netzwerk spezifiziert. Der Agent signiert die Zahlung und wiederholt die Anfrage mit dem unterschriebenen Nachweis in der `X-PAYMENT` Kopfzeile. Der Händler verifiziert die Zahlung und liefert den Inhalt.
### Mikrotransaktion
Eine Mikrotransaktion ist eine geringe Zahlung (oft in Cent) für einen einzelnen API-Aufruf, einen Tool-Aufruf oder einen Inhaltszugriff. Herkömmliche Zahlungssysteme haben minimale Transaktionskosten und sind daher für Zahlungen unter 0,01$ ineffizient. AgentCore Bei Zahlungen werden Kryptowährungen und Stablecoins verwendet, um kostengünstige Mikrozahlungen zu ermöglichen.