Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

Integrieren Sie das Protokoll für Agentic CommercePrivate Vorschau

Erfahren Sie, wie Sie ACP in Stripe integrieren.

Das Agentic Commerce Protocol (ACP) ist eine Open-Source-Spezifikation für den Handel zwischen kompatiblen Anwendungen wie ChatGPT und Verkäufern. Sie können es als RESTful-Schnittstelle oder als MCP-Server implementieren.

Sie können das Agentic Commerce Protocol verwenden, um Ihren Bezahlvorgang für Anwendungen zum Initiieren und Abschließen von Bezahlvorgängen zugänglich zu machen. Anwendungen können Zahlungsdaten, einschließlich des SharedPaymentToken von Stripe, sicher für die Verarbeitung in Ihrem bestehenden Zahlungs-Stack teilen.

Bei einem typischen Bezahlvorgang ist beispielsweise allein der/die Verkäufer/in für die Nutzeroberfläche, das Datenmodell und die Zahlungsabwicklung zuständig. Der/Die Verkäufer/in zeigt eine Bezahlvorgangseite an, speichert Daten zum Warenkorb und zur Bestellung, erhebt Zahlungsdaten und wickelt die Zahlung ab.

Im Gegensatz dazu ist der KI-Agent bei einem Agentic-Commerce-Bezahlvorgang für die Präsentation der Schnittstelle des Bezahlvorgangs und das Erheben von Zahlungsinformationen verantwortlich, während der/die Verkäufer/in für sein/ihr bestehendes Datenmodell und die Zahlungsabwicklung verantwortlich ist.

Weitere Informationen finden Sie auf der ACP-Website.

Lebenszyklus

In diesem Abschnitt werden die Schritte des Bezahlvorgangs beschrieben: von der anfänglichen Kaufabsicht über die Bestellung bis zur Bestätigung der Zahlung durch den/die Verkäufer/in.

  1. Die/der Käufer/in kommuniziert ihre/seine Bestellabsicht und der Agent initiiert den Bezahlvorgang mit einer CreateCheckoutRequest bei dem/der Verkäufer/in.
  2. Der Verkäufer bearbeitet die Anfrage und generiert einen Warenkorb und antwortet dann mit dem aktuellen Status des Bezahlvorgangs.
  3. Der Agent rendert die Nutzeroberfläche (eine Bezahlvorgang-Schnittstelle, Text usw.), um den aktuellen Status (z. B. Gesamtsumme) und die Optionen (z. B. Versand) an den/die Käufer/in weiterzuleiten.
  4. Nachdem der/die Käufer/in eine Auswahl getroffen hat, kommunizieren Agent und Verkäufer/in über UpdateCheckoutRequest miteinander.
  5. Nachdem der/die Käufer/in seine/ihre Zahlungsabsicht zum Ausdruck gebracht hat, stellt der Agent ein SharedPaymentToken bereit, das auf den Betrag und den/die Verkäufer/in eingestellt ist und das mit einer CompleteCheckoutRequest an den/die Verkäufer/in weitergegeben wird.
  6. Die Verkäufer/innen erstellen einen PaymentIntent und senden eine Bestätigung an den Agenten.

Endpoints

Verkäufer/innen stellen ihren Bezahlvorgang Agenten zur Verfügung, mit denen sie interagieren können, indem sie eine RESTful HTTP-Schnittstelle zu dieser Spezifikation mit den vier folgenden Endpoints erstellen.

So wird der Bezahlvorgang abgewickelt:

  1. Bezahlvorgang-Objekt erstellen: Geben Sie eine eindeutige SKU an, um die Warenkorb- und Bezahlvorgangsdaten in Ihrem Backend zu generieren. Ihre Antwort enthält Details zu unterstützten Zahlungsmethoden, Ausführungsoptionen und mehr.
  2. Checkout-Objekt aktualisieren: Aktualisieren Sie Änderungen wie Posten-Mengen, Ausführungsmethoden und Käuferdaten, während der/die Käufer/in durch den Bezahlvorgang navigiert.
  3. Bezahlvorgang abschließen: Übergeben Sie das SharedPaymentToken in einer Anfrage. Wickeln Sie Ihre Zahlung während dieser Anfrage ab und antworten Sie mit den Bestelldetails.
  4. Bezahlvorgang-Objekt stornieren: Benachrichtigen Sie den Agenten über die Stornierung, wenn der/die Käufer/in den Bezahlvorgang verlässt oder abbricht, damit Sie den Bestand freigeben und den Bezahlvorgangstatus auf „storniert“ aktualisieren können.

Jede Endpoint-Antwort enthält den aktuellen Status des Bezahlvorgangs und dient als Referenzpunkt für den Agenten.

Ereignisse

Benachrichtigen Sie den Agenten nach Abschluss des Bezahlvorgangs über die Erstellung und Aktualisierung der Bestellung. Bringen Sie ihn beispielsweise auf den neuesten Stand, nachdem eine Bestellung versendet wurde. So kann der Agent Statusänderungen kommunizieren, Aktionen anfordern oder andere Informationen an Käufer/innen weitergeben.

Sicherheit

Befolgen Sie die folgenden Richtlinien, um die Integrität von Transaktionen zu wahren und vertrauliche Informationen innerhalb des Agentic-Commerce-Frameworks zu schützen:

  • Alle Anfragen erfordern HTTPS und enthalten Authorization: Bearer{token}.
  • Signieren Sie alle Webhook-Ereignisse und fügen Sie eine HMAC-Signatur als Anfrage-Header hinzu.
  • Die Agent-Anwendung muss Autorisierungs- und Signierungsschlüssel beim Onboarding bereitstellen.