Kontextbezogenes Einkaufen auf KI-Agenten aktivierenPrivate Vorschau

Um Ihre Plattform und die verbundenen Konten für kontextbezogenes agentenbasiertes Verkaufen zu konfigurieren, geben Sie bitte die folgenden Details an:

• Plattform-Stripe-Konto-ID.
• Verbundene Konto-IDs. Bitte stellen Sie eine Liste der verbundenen Konto-IDs zur Verfügung, um kontextbezogenes Verkaufsverhalten zu ermöglichen. Sie können eine Tabelle oder eine reine Textdatei senden, wobei jede Zeile eine Konto-ID enthält.

Product Catalog vorbereiten

Erstellen Sie für jedes verbundene Konto eine CSV-Datei, die den Spezifikationen des Stripe-Product Catalog entspricht. Stripe stellt die Spezifikationen separat zur Verfügung.

Katalogdaten bei Stripe hochladen

Übermitteln Sie den Feed über die Stripe-APIs. Sie können alle 15 Minuten Aktualisierungen senden.

Nutzen Sie die Sandbox, um die Analyse, Feldzuordnungen und Datenqualität zu überprüfen, 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 data_management_manual_upload als purpose an.
• Stellen Sie sicher, dass der MIME-Typ mit dem Dateiformat übereinstimmt. Akzeptierte Formate sind CSV und TSV, wobei jede Zeile ein Produkt oder eine Variante darstellt.
• Die maximale Dateigröße beträgt 200 MB.

curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -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)

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

Feed-Status überwachen

Stripe verarbeitet die Katalogdaten, validiert und bereinigt sie, bevor sie in einem Format indiziert werden, das Stripe validiert und bereinigt die Katalogdaten, indiziert sie und konvertiert sie in ein Format für KI-Agenten. Überwachen Sie den Indizierungsfortschritt mithilfe des Felds status im Import-Set. Der Status kann pending, failed, succeeded, succeeded_with_errors, pending_archive oder archived sein.

curl https://api.stripe.com/v1/data_management/import_sets/{{IMPORT_SET_ID}} \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

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:

1. Suchen Sie das Feld result.errors.file in der Antwort.
2. Verwenden Sie die Datei-API, um die Fehlerdatei anhand ihrer ID abzurufen.
3. Die heruntergeladene CSV-Datei enthält Ihre ursprünglichen Daten mit einer führenden alte namens stripe_error_message, die beschreibt, warum jede Zeile fehlgeschlagen ist.

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 fehlgeschlagenen Zeilen enthält, mit einer Spalte stripe_error_message, in der jeder Fehler beschrieben wird.

Nutzen Sie Stripe-Webhooks, um Bestellungen zu überwachen, die über KI-Chat-Agenten getätigt werden.

Wenn eine Bestellung bestätigt wird, sendet Stripe Webhook-Ereignisse, die Ihr Server verarbeiten kann, um die Fulfillment-Logik auszuführen. Richten Sie einen Endpoint auf Ihrem Server ein, um diese Ereignisse zu akzeptieren, zu verarbeiten und zu bestätigen. Im Webhooks-Handbuch finden Sie eine Schritt-für-Schritt-Anleitung zur Integration und zum Testen von Stripe-Webhooks.

Stripe sendet checkout.session.completed und payment_intent.succeeded. Wenn Ihre Fulfillment-Logik diese Ereignisse bereits verarbeitet, sind keine zusätzlichen Integrationsänderungen erforderlich. Sie können Ihre Fulfillment-Logik für kontextbezogene Verkäufe durch Agenten anpassen (z. B. indem Sie in Ihrer Bestellbestätigungs-E-Mail darauf hinweisen, dass die Kaufabwicklung durch einen Agenten erfolgt ist).

const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);

// Use the secret provided by Stripe CLI for local testing
// or your webhook endpoint's secret
const endpointSecret = 'whsec_...';

app.post('/webhook', (request, response) => {
  const sig = request.headers['stripe-signature'];
  let event;

  try {
    event = stripe.webhooks.constructEvent(request.body, sig, endpointSecret);
  } catch (err) {
    response.status(400).send(`Webhook Error: ${err.message}`);
    return;
  }

  if (event.type === 'checkout.session.completed') {
    const session = event.data.object;
    // Fulfill the order using the session data
    fulfillCheckout(session.id);
  }

  response.status(200).send();
});