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

Erfahren Sie, wie Sie mit dem Verkauf Ihrer Produkte im Kontext mit KI-Agenten beginnen.

Private Vorschau

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

Hinweis

Dieser Leitfaden richtet sich an E-Commerce-Unternehmen. Wenn Sie ein Marktplatz sind und kontextbezogene agentische Verkäufe auf Ihrer Plattform anbieten möchten, lesen Sie unseren Leitfaden für Plattformen und Marktplätze.

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.

Begeben Sie sich anschließend im Stripe-Dashboard zu Onboarding für agentenbasierten Handel. Dort werden Sie durch die Erstellung eines Stripe-Profils und die Konfiguration verschiedener Einstellungen für agentenbasierten Handel geführt.

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 Feeds in jedem Takt hochladen. Um die Daten aktuell zu halten, laden Sie Produktdaten einmal täglich hoch und senden Sie häufigere inkrementelle Updates für Bestand und Preise.

Hinweis

Feed-Uploads werden als unabhängige, asynchrone Aufgaben verarbeitet. Wir garantieren nicht, dass Uploads in der Reihenfolge verarbeitet oder abgeschlossen werden, in der Sie sie übermitteln. Wenn Sie mehrere Dateien kurz hintereinander hochladen, kann ein späterer Upload vor einem früheren abgeschlossen sein.

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 Ihre Katalogdaten, validiert und bereinigt sie und indexiert sie dann in einem Format, das Sie an KI-Agenten senden können. Sie können den Fortschritt der Indexierung von Stripe auf zwei Arten überwachen:

Stellen Sie eine GET-Anfrage und prüfen Sie das Feld Status auf dem ImportSet-Objekt. Der Status kann ausstehend, fehlgeschlagen, erfolgreich, succeeded_with_errors, pending_archive, oder archiviert 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.

Wenn Sie den Verkauf auf einem KI-Chat-Agenten unterbrechen oder einstellen möchten, deaktivieren Sie den Agenten im Dashboard.

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 überprüfen wir vor der Bestätigung einer Zahlung den Lagerbestand anhand Ihrer Product-Catalog-Daten und führen mit Radar Betrugsüberprüfungen durch. Um zusätzliche Kontrolle über den Abschluss eines Kaufs zu erhalten, konfigurieren Sie bitte einen manuellen Genehmigungs-Hook. Bevor wir den Kaufvorgang abschließen, senden wir eine Genehmigungsanfrage an Ihren Dienst. Genehmigen oder lehnen Sie die Anfrage ab. Stripe legt für Ihren Hook eine Zeitüberschreitungsschwelle von zwei Sekunden fest. Wenn Ihr Hook nicht innerhalb dieser Schwelle antwortet, lehnt Stripe die Zahlung ab.

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

Geben Sie den Endpoint auf der Seite Einstellungen für den agentenbasierten Handel 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: "v1.delegated_checkout.finalize_checkout",
  id: String,
  livemode: Boolean,
  // account ID
  context?: String,
  // request specific data
  data: {
    amount_subtotal?: Number,
    amount_total?: Number,
    billing_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      }
    },
    currency: String,
    email?: String,
    line_items_details: Array<{
      id: String,
      unit_amount: Number,
      quantity: Number,
      name: String
    }>,
    payment_method_details?: {
      type: "card" | ...,
      card?: {
        brand: "amex" | "visa" | "master_card" | ...,
        country?: String,
        exp_month: Number,
        exp_year: Number,
        fingerprint?: String,
        funding: "credit" | "debit" | "prepaid" | "unknown",
        iin?: String,
        last4: String,
        wallet?: {
          type: "apple_pay" | "google_pay" | ...
        }
      }
    },
    phone?: String,
    shipping_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      },
    },
    total_details?: {
      amount_discount?: Number,
      amount_shipping?: Number,
      amount_tax?: Number
    }
  }
}

Format der Antwort auf die Genehmigung vor der Bestätigung

HTTP/1.1 200 OK
{
  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 für Versandoptionen

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"

OptionalInkrementelle Preisaktualisierungen senden

Bitte laden Sie Ihren Product Catalog hoch und senden Sie anschließend einzelne Preisaktualisierungen über die Price Feed API. Verwenden Sie denselben Upload-Vorgang wie für Catalog-Uploads und setzen Sie standard_data_format auf price_feed.

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="price_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