Kontextbezogene Verkäufe auf KI-Agenten ermöglichenPrivate Vorschau

Erfahren Sie, wie Sie mit dem kontextbezogenen Verkauf Ihrer Produkte auf KI-Agenten mit einer Low-Code-Lösung beginnen.

Private Vorschau

Wenn Ihr Unternehmen agentenbasierten Handel nutzen möchte, um Produkte zu verkaufen, tragen Sie sich in die Warteliste ein.

Hinweis

This guide is for e-commerce businesses. If you’re a marketplace and want to offer in-context agentic selling on your platform, see our guide for platforms and marketplaces.

Stripe-Konto einrichten

Wenn Sie noch kein Stripe-Konto haben, erstellen Sie eines. Nachdem Sie Ihre E-Mail-Adresse verifiziert haben, müssen Sie Zahlungen aktivieren, indem Sie detaillierte Unternehmensdaten und persönliche Daten angeben, ein Bankkonto für Auszahlungen verknüpfen und Sicherheitsfunktionen wie die Zwei-Faktor-Authentifizierung einrichten.

Then, create your business’s public identity by setting up a Stripe profile in the Dashboard.

Steuern konfigurieren

Verwenden Sie Stripe Tax, um Steuern zu verwalten und Konfigurationen auf einzelne Produkte anzuwenden. Befolgen Sie den Leitfaden zur Steuereinrichtung, um Stripe Tax zu konfigurieren.

Legen Sie in Ihrem Product Catalog-CSV-Upload die Spalte stripe_product_tax_code fest, um ein Produkt einer Steuerbehandlung zuzuordnen.

Stripe unterstützt auch Steuerberechnungen durch externe Steueranbieter, einschließlich Anrok, Avalara, Sphere.

Laden Sie Ihre Product Catalog-Daten bei Stripe hoch

Erstellen Sie eine CSV-Datei, die den Spezifikationen des Stripe Product Catalog entspricht.

Katalogdaten bei Stripe hochladen

Übermitteln Sie den Feed im Stripe-Dashboard oder über die Stripe-API. Sie können alle 15 Minuten Updates senden.

Sie können Stripe-APIs verwenden, um Ihre Product Catalog-CSV hochzuladen. Wir empfehlen die Verwendung von Sandbox, um das Parsing, Feldzuordnungen und die Datenqualität zu validieren, bevor Sie Live-Updates aktivieren.

Laden Sie zunächst Ihre Product Catalog-CSV über die Files API hoch. Eine erfolgreiche Anfrage gibt ein File-Objekt zurück, das die id enthält.

Geben Sie den Zweck data_management_manual_upload an.
Der MIME-Typ des Datei-Uploads muss dem Dateiformat entsprechen. Zu den zulässigen Formaten gehören CSV und TSV, wobei jede Zeile ein Produkt oder eine Variante darstellt.
Die maximale Dateigröße beträgt 200 MB.

Command Line
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

Verwenden Sie dann die Data Management API, um ein ImportSet zu erstellen. Dieser Aufruf startet die Katalogverarbeitung und stellt die Daten im Dashboard zur Verfügung. Fügen Sie Folgendes ein:

Die zurückgegebene Datei id
Der Vorschau-Header (zum Beispiel Stripe-Version: 2025-09-30.clover;udap_beta=v1)

Command Line
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="product_catalog_feed"

Status des Feeds überwachen und Fehler beheben

Stripe verarbeitet die Katalogdaten, validiert und bereinigt sie, bevor sie in einem Format indiziert werden, das an KI-Agenten gesendet werden kann. Sie können den Indexierungsfortschritt von Stripe über das Feld status im ImportSet überwachen. Der Status kann pending, failed, succeeded, succeeded_with_errors, pending_archive oder archived sein.

Command Line
curl https://api.stripe.com/v1/data_management/import_sets/{{IMPORT_SET_ID}} \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Die Antwort enthält den Status und etwaige Fehler:

{
  "id": "impset_7MabcdZ8b617780e5145413",
  "object": "data_management.import_set",
  "created": 1643992696,
  "livemode": true,
  "result": {
    "errors": {
      "file": "file_234923sIENc",
      "row_count": 30
    },
    "rows_processed": 120,
    "successes": {
      "row_count": 90
    }
  },
  "status": "succeeded_with_errors"
}

Wenn Ihr Import-Status succeeded_with_errors lautet, können Sie den Fehlerbericht herunterladen:

Suchen Sie nach dem Feld result.errors.file in der Antwort.
Verwenden Sie die Files API, um den Inhalt der Fehlerdatei mithilfe der Datei-ID abzurufen.
Die heruntergeladene CSV-Datei enthält Ihre ursprünglichen Daten mit einer führenden Spalte namens stripe_error_message, die beschreibt, warum jede Zeile fehlgeschlagen ist.

Command Line
curl https://files.stripe.com/v1/files/{{ERROR_FILE_ID}}/contents \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Die API gibt eine CSV-Datei zurück, die nur die Zeilen enthält, die fehlgeschlagen sind, wobei die Spalte stripe_error_message jeden Fehler beschreibt.

Auf Einkäufe reagieren und Bestellungen ausführen

Sie können Bestellungen, die über KI-Chat-Agenten aufgegeben wurden, auf drei Arten überwachen:

Zeigen Sie Bestellungen auf der Transaktionsseite im Dashboard an – sie sind mit dem ursprünglichen Agenten gekennzeichnet.

Verkauf auf KI-Chat-Agenten aktivieren

Wenn Sie bereit sind, mit einem KI-Chat-Agenten zu verkaufen, prüfen Sie die Konditionen des Agenten und aktivieren Sie ihn im Stripe-Dashboard. Stripe sendet dem Agenten eine Anfrage zur Genehmigung, die der Agent akzeptieren muss.

Um den Verkauf eines KI-Chat-Agenten zu unterbrechen oder einzustellen, deaktivieren Sie den Agenten im Dashboard oder senden Sie eine Anfrage über die Stripe-API:

Command Line
curl -X POST https://api.stripe.com/v2/agentic_commerce/agreements/{{AGREEMENT_ID}}/terminate \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Wir senden Webhooks, wenn Ihre Vereinbarung mit einem KI-Agenten bestätigt oder gekündigt wird:

agentic_commerce_agreement.confirmed
agentic_commerce_agreement.terminated

OptionalManuelle Erfassung einrichten

Standardmäßig erfasst Stripe Zahlungen sofort nach dem Kauf. Um manuell zu erfassen, öffnen Sie im Dashboard die Seite „Agentische Einstellungen“ und setzen Sie den Erfassungsmodus auf „Manuell“. Wenn Sie die manuelle Erfassung aktivieren, rufen Sie die Methode capture im PaymentIntent auf:

Command Line
curl -X POST https://api.stripe.com/v1/payment_intents/pi_3MrPBM2eZvKYlo2C1TEMacFD/capture \
  -u "<secret_key>:" \
  -H "Stripe-Version: 2025-09-30.preview"

OptionalHook für Genehmigungen vor der Bestätigung einrichten

Standardmäßig prüfen wir vor der Bestätigung einer Zahlung den in Ihrem Product Catalog definierten Bestand und führen Betrugsprüfungen mit Radar durch. Um die Kontrolle darüber zu erhalten, ob ein Kauf abgeschlossen werden soll, konfigurieren Sie einen Hook für manuelle Genehmigungen. Bevor wir den Bezahlvorgang abschließen, senden wir eine Anfrage zur Genehmigung an Ihren Service. Genehmigen Sie die Anfrage oder lehnen Sie sie ab.

So richten Sie einen Hook für manuelle Genehmigungen ein:

Geben Sie den Endpoint im Dashboard an.
Implementieren Sie Ihre Logik am Endpoint und verwenden Sie die folgenden Anfrage- und Antwortformate.

Format der Anfrage für die Genehmigung

Stripe sendet die folgende Anfrage an Ihren Endpoint:

{
  type: String,
  id: String,
  livemode: Boolean,
  // account ID
  context?: String,
  // request specific data
  data: {
    amount_total: Integer,
    amount_subtotal: Integer,
    total_details?: {
      amount_discount?: Number,
      amount_fulfillment?: Number,
      amount_tax?: Number
    },
    currency: String,
    line_items_details: Array<{
      sku_id: String,
      unit_amount: Number,
      quantity: Number,
      amount_subtotal: Integer,
      amount_total: Integer,
      amount_tax: Integer,
      amount_discount: Integer
    }>,
    payment_method_details?: {
      type: "card" | ...,
      card?: {
        brand: "amex" | "visa" | "master_card" | ...,
        country?: String,
        exp_month: Number,
        exp_year: Number,
        funding: "credit" | "debit" | "prepaid" | "unknown",
        last4: String,
        wallet?: {
          type: "apple_pay" | "google_pay" | ...
        }
      },
      billing_details?: {
        name?: String,
        address?: {
          line1?: String,
          line2?: String,
          city?: String,
          state?: String,
          postal_code?: String,
          country?: String
        }
      },
    },
    fulfillment_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      },
      email?: String,
      phone?: String,
    }
  }
}

Format der Antwort

{
  manual_approval_details?: {
    type: "approved" | "declined",
    declined?: {
      reason: String
    }
  }
}

OptionalVersandoptionen-Hook einrichten

Standardmäßig berechnet Stripe die Versandoptionen für Ihre Produkte anhand der in Ihrem Product Catalog definierten Optionen. Jede Option enthält einen Namen, eine Beschreibung, eine geschätzte Lieferzeit und Kosten. Sie können den kostenlosen Versand pro Produkt im Product Catalog konfigurieren.

Um Versandoptionen und -kosten dynamisch mit Ihrer eigenen Logik zu berechnen, implementieren Sie den Versandoptionen-Hook. Wir rufen Ihren Hook auf, bevor wir den Bezahlvorgang mit den Artikeln im Warenkorb an den Agenten zurückgeben. Die Nutzeroberfläche des Agenten rendert dann die von Ihnen berechneten Versandoptionen und Preise.

Format der Anfrage

Das folgende Beispiel zeigt die Eingaben in der Anfrage compute_shipping_options, die wir an den von Ihnen konfigurierten Reverse API Endpoint zur Berechnung der Versandoptionen senden:

{
  livemode: Boolean,
  currency: String,
  amount_total: Integer,
  amount_subtotal: Integer,
  total_details?: {
      amount_discount?: Number,
      amount_tax?: Number
  },
  line_items_details: [
      {
        sku_id: String,
        unit_amount: Integer,
        quantity: Integer,
        amount_subtotal: Integer,
        amount_total: Integer,
        amount_tax: Integer,
        amount_discount: Integer
      }
    ],
  fulfillment_details?: {
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      }
    }
  }

Format der Antwort

HTTP/1.1 200 OK
{
  fulfillment_options: [
    {
        display_name: String,
        description: String,
        earliest_delivery_time: Integer,
        latest_delivery_time: Integer,
        shipping_amount: Integer
     }
  ]
}

OptionalInkrementelle Bestandsaktualisierungen senden

Senden Sie zusätzlich zum Hochladen Ihres Product Catalog einzelne Produktbestandsaktualisierungen über die Inventory Feed API. Verwenden Sie denselben Prozess wie beim Catalog-Upload, legen Sie jedoch standard_data_format auf inventory_feed fest:

Command Line
# Step 1: Upload your CSV using the Files API
curl https://files.stripe.com/v1/files \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

# Step 2: Create an ImportSet object
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="inventory_feed"

OptionalRückerstattungen und Zahlungsanfechtungen abwickeln

Wenn ein Kunde/eine Kundin nach erfolgreichem Bezahlvorgang die Bestellung auf Ihrer Website oder über den Kundenservice storniert, veranlassen Sie eine Rückerstattung. Wenn Sie bereits die Checkout Sessions oder PaymentIntents API verwenden, funktioniert Ihr bestehender Workflow für Rückerstattungen ohne Änderungen für agentische Bezahlvorgänge.

Sie können Rückerstattungen und Zahlungsanfechtungen im Dashboard auf der Transaktionsseite verwalten oder die Refunds API verwenden, um Stornierungen und Rückerstattungen programmgesteuert abzuwickeln.

Siehe auch

Gemeinsam genutzte Zahlungstoken