Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtZahlung annehmenAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed PaymentsWiederkehrende Zahlungen
Präsenzzahlungen
Zahlungsmethoden
Zahlungsvorgänge
Salden und AbwicklungsdauerZahlungsbelegeRückerstattungen und Stornierungen
Erweiterte Integrationen
Mehr als Zahlungen

Integrieren Sie das Protokoll für Agentic CommercePrivate Vorschau

Erfahren Sie, wie Sie das Agentic Commerce Protocol (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 Zahlungsbestätigung durch die Verkäuferin/den Verkäufer.

  1. Die Kundin/Der Kunde 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 die Kundin/den Kunden weiterzuleiten.
  4. Nachdem die Kundin/der Kunde eine Auswahl getroffen hat, kommunizieren Agent und Verkäufer/in über UpdateCheckoutRequest miteinander.
  5. Nachdem die Kundin/der Kunde ihre/seine 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 Kundendaten, während die Kundin/der Kunde 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. Ein Checkout-Objekt stornieren:: Benachrichtigen Sie den Agenten über die Stornierung, wenn die Kundin/der Kunde den Bezahlvorgang verlässt oder schließt, damit Sie den Bestand freigeben und den Status des Bezahlvorgangs 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 Kundinnen und Kunden 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.