AP2-Agent-Zahlungsprotokoll: ein Entwicklerleitfaden mit über 60 Partnern

Google hat das Agent Payments Protocol (AP2) mit mehr als 60 Partnern ausgeliefert, darunter Mastercard und Visa (über Worldpay), American Express, PayPal, Coinbase, Salesforce, ServiceNow, Adyen und JCB. Die Spezifikation beantwortet eine Frage: Wenn ein KI-Agent etwas in Ihrem Namen bezahlt, wer hat unterschrieben? Was und wie löst ein Kartennetzwerk eine Rückbuchung drei Wochen später?

Stripe Checkout und Apple Pay gehen davon aus, dass ein Mensch auf eine Schaltfläche geklickt hat. Der Agentenhandel macht das kaputt Annahme. Wenn Ihr Einkaufsagent um 3 Uhr morgens ein Hotel bucht, während Sie schlafen, und das Zimmer Wanzen hat, Das Streitverfahren muss rekonstruieren, ob Sie berechtigt sind Das kaufen oder verschenken Agent einen Blankoscheck. AP2 antwortet mit signierten Mandaten: kleine, strukturierte Objekte, die einen binden Agent zu einer Benutzerabsicht mit kryptografischem Beweis.

Hier ist die sechsteilige Aufschlüsselung, die Entwickler benötigen, um AP2 mit einem Agenten zu verbinden, sowie den Kryptopfad über die A2A x402-Erweiterung, die bereits live in der Produktion ist.

Teil 1: Mandate sind die atomare Einheit

Ein Mandat ist ein JSON-Objekt, das der Identitätsanbieter des Benutzers signiert, wenn der Mensch eine Klasse autorisiert der Einkäufe. Jede nachgelagerte Zahlung verweist per ID auf das Mandat; Händler überprüfen das Unterschreiben, Einschränkungen prüfen und abwickeln. So sieht man auf dem Draht aus:

Vier Felder tragen Gewicht. intent ist das einfache Englisch, nach dem der Benutzer gefragt hat. constraints ist der maschinenlesbare Umschlag: Höchstbetrag, Währung, Markenzulassungsliste, Kategorie. valid_until begrenzt, wie lange der Agent das Mandat ausführen kann. signature ist ein Ed25519- oder ECDSA-Nachweis, dass der Aussteller (Google Pay, Auth0 für Agenten, der Identitätsdienst einer Bank) haben die Nutzdaten tatsächlich signiert.

Einschränkungen sind der Ort, an dem Produktarbeit stattfindet. Ein Mandat mit max_amount: 10000 und keine Markenzulassungsliste ist ein Agenten-Blankoscheck. Ein Mandat mit max_amount: 200, brand_allowlist: [...], category: "footwear" ist ein Bereich Autorisierung, über die ein Händler nachdenken kann. Behandeln Sie das Mandat-Constraint-Design genauso wie Sie OAuth-Bereichsdesign: der engste Satz, den das Produkt zulässt.

Teil 2: AP2 läuft als A2A-Erweiterung

AP2 erfindet den Transport nicht neu. Es basiert auf Agent2Agent, dem offenen JSON-RPC-Protokoll von Google veröffentlicht im Jahr 2025 für die Agent-zu-Agent-Kommunikation. Eine A2A-Aufgabe mit Zahlungsabsicht trägt die Mandat innerhalb der extensions.ap2 Feld des Umschlags:

Der Empfängeragent (hier der Einkaufsagent des Händlers) liest die A2A-Aufgabe und sieht die ap2 Erweiterung, überprüft das Mandat über seinen PSP und nimmt entweder die Aufgabe an oder gibt eine unterschriebene Ablehnung zurück. Für Entwickler, die bereits A2A sprechen, ist das Hinzufügen von AP2 ein Erweiterungsschlüssel im Aufgabenumschlag plus Verifizierungsaufruf; es ist kein paralleler Stapel.

Teil 3: x402 wickelt heute Kryptozahlungen ab

Karteninhaber verhandeln immer noch über die Haftung für Rückbuchungen. Krypto bewegte sich schneller. Der A2A x402 Erweiterung (gemeinsam mit Coinbase, der Ethereum Foundation und MetaMask entwickelt) ist Produktionsbereit und Wiederverwendung von HTTP 402. Für die Aushandlung der Abrechnung erforderliche Zahlung:

Der Ablauf besteht aus vier Schritten: Anfrage, 402 mit Zahlungsanforderungen, unterzeichnete Überweisung, die die Nonce bindet zum Mandat, versuchen Sie es erneut mit der Quittung. Händler überprüfen die On-Chain-Übertragung vor der Freigabe die Ressource. Die Abrechnung erfolgt heute über USDC auf Basis oder Optimismus; Stablecoin-Schienen halten die UX in der Nähe zu Kartenkäufen ohne schwankende Währungsabweichung zwischen Unterzeichnung und Bestätigung.

Teil 4: Fordern Sie ein Mandat von Python an

So sieht die Agentenseite in Python mit dem Referenz-AP2-SDK aus. Der Agent fragt den Der Identitätsanbieter des Benutzers für ein Mandat empfängt ein signiertes Objekt und leitet es über eine A2A weiter Aufgabe an den Händler:

Zwei Details sind wichtig. Der Signaturschlüssel befindet sich in einem KMS (Google Cloud KMS, AWS KMS, HashiCorp Vault). Eine exfiltrierte Agenten-Binärdatei kann also keine Identität fälschen. Das Mandat ist bei allen Händlern wiederverwendbar während valid_until; Der Benutzer autorisiert einmal, der Agent kauft an vielen Orten ein. Das Wiederverwendung ist der gesamte UX-Grund, warum AP2 existiert; Ohne sie fordert jeder Händler den Benutzer erneut dazu auf Die Agentenerfahrung bricht zusammen.

Teil 5: Überprüfen Sie ein Mandat von Ihrem Händler-Backend

Auf der Händlerseite liegt der größte Teil der Betrugsfläche. Die Verifizierung muss vier umfassen Dinge: Gültigkeit der Signatur, Vertrauen des Ausstellers, Übereinstimmung mit Einschränkungen und Ablauf. Schneiden Sie bei jedem davon Abstriche sie und du versendest ein Loch:

Drei Muster, die es wert sind, kopiert zu werden. Behalten Sie eine issuerAllowlist; Akzeptieren Sie keine Mandate von jeder Emittent, der auftaucht. Erzwingen clockSkewSeconds; Agenten über instabile Netzwerke senden Zeitstempel routinemäßig 15 Sekunden in der Zukunft. Speichern Sie die Mandats-ID, die Agenten-ID und die Benutzer-ID in Ihre PSP-Metadaten, sodass ein Rückbuchungsstreit in drei Wochen die Kette ohne erneutes Abspielen abwickeln kann Supporttechniker taucht in Protokolle ein.

Teil 6: Erstellen Sie einen Warenkorb mit mehreren Währungen rund um das Mandat

Agentenkäufer wechseln ständig ihre Währungen. Ein Benutzer in Tokio überreicht einem Agenten ein USD-Mandat; die Der Agent findet ein Angebot bei einem europäischen Händler mit einem Preis in EUR. Der Händler muss die USD-Obergrenze kennen vor Annahme des Mandats in EUR umrechnen. Ein Währungsumrechnungsaufruf behält die Mathematik bei ehrlich:

Speichern Sie den Tarif für die Laufzeit des Mandats. Wenn sich die Rate um mehr als ein konfiguriertes Band bewegt (typisch: 2 %), bitten Sie den Benutzer, erneut zu unterschreiben. Die Art und Weise, wie Agenten produzieren, ist, sich mit einem veralteten Tarif abzufinden Support-Tickets.

Was AP2 an Ihrem Stack ändert

Wichtige Erkenntnisse

• Mandate ersetzen Inhaberberechtigungsnachweise. Der Agent trägt eine unterzeichnete Absicht, nicht eine Kartennummer; Der Händler überprüft den Umfang, bevor er Gebühren erhebt.
• AP2 läuft auf A2A. Ein Erweiterungsschlüssel im JSON-RPC-Umschlag, kein neuer Transport; Wenn Ihr Agent bereits A2A spricht, sind Sie nur noch einen Bestätigungsanruf entfernt.
• x402 ist heute der Kryptopfad in der Produktion. HTTP 402 plus USDC auf Basis oder Optimismus, da Coinbase und MetaMask bereits Kunden beliefern.
• Constraint-Design ist Scope-Design. Behandeln max_amount, Zulassungslisten und valid_until als OAuth-Bereiche von Agentenzahlungen.
• Speichern Sie die Mandatskette in Ihren PSP-Metadaten. Eine Rückbuchung drei Wochen später Sie können nicht bestreiten, was Sie nicht aufgezeichnet haben.

Botoi stellt die unterstützenden Endpunkte bereit, auf die sich ein AP2-Händlerablauf stützt: Währungsumrechnung, Ländersuche, IP- und VPN-Erkennung, Adressvalidierung und BIN-Suche für Kartenmetadaten. Eins API-Schlüssel, 5 Anforderungen/Min. im kostenlosen Kontingent. Durchsuchen Sie die interaktive Dokumente oder verkabeln MCP-Server hinein Ihr Agent, damit Claude oder Cursor dieselben Endpunkte aus dem Editor heraus aufrufen können.