Stripe Integration Template

Integriere Stripe-Payment-Processing in deine Mid-call Actions und ermögliche es deinem KI-Assistenten, während Kundengesprächem Zahlungen zu initiieren, Payment-Intents zu erstellen und Subscription-Checkouts zu starten.

Überblick & Funktionen

Payment-Intent-Management

Sofortige Zahlungsvorbereitung während des Gesprächs
Support für einmalige Zahlungen und Subscriptions
Multi-Currency-Unterstützung (EUR, USD, GBP, etc.)
PCI-DSS-konforme Zahlungsabwicklung

Customer & Order-Integration

Automatische Customer-ID-Verknüpfung
Order-Metadata für Business-Intelligence
Integration mit bestehenden E-Commerce-Systemen
Webhook-basierte Payment-Status-Updates

Stripe Account & API Setup

1. Stripe Dashboard vorbereiten

Stripe Account einrichten

Registriere dich bei Stripe oder logge dich ein
Vervollständige dein Business-Profil für Live-Zahlungen
Aktiviere relevante Payment-Methods (Karten, SEPA, etc.)

API Keys abrufen

API-Keys-Location:
  1. Stripe Dashboard → "Developers" → "API keys"
  2. Zwei Key-Typen verfügbar:
     - Publishable Key (pk_test_ oder pk_live_)
     - Secret Key (sk_test_ oder sk_live_)
  
Für Mid-call Actions benötigt:
  - Secret Key (für Server-to-Server API-Calls)
  - Test-Environment: sk_test_...
  - Production: sk_live_...

Webhooks konfigurieren

Webhook-Setup für Payment-Updates:
  1. "Developers" → "Webhooks" → "Add endpoint"
  2. Endpoint URL: https://your-app.com/stripe-webhook
  3. Events to send:
     - payment_intent.succeeded
     - payment_intent.payment_failed
     - payment_intent.canceled
  4. Webhook-Secret für Verification notieren

Customer-Management vorbereiten

Existing Customers in Stripe identifizieren
Customer-ID-Mapping zu internen CRM-Systemen
Default-Payment-Methods und Billing-Details überprüfen

Payment-Intent-Tool konfigurieren

Konfiguration im Famulor Interface

Werkzeugdetails
Header-Konfiguration
Body Template (Form Data)

Feld	Wert
Name*	`Stripe Zahlung initiieren`
Beschreibung	”Erstellt einen Payment Intent in Stripe für sichere Zahlungsabwicklung während des Kundengesprächs”
Funktionsname*	`create_stripe_payment`
Funktionsbeschreibung*	“Erstellt einen Payment Intent für eine Zahlung. Verwende dies, wenn ein Kunde bereit ist zu bezahlen oder eine Anzahlung leisten möchte.”
HTTP-Methode	`POST`
Timeout (ms)	`5000`
Endpoint*	`https://api.stripe.com/v1/payment_intents`

{
  "Authorization": "Bearer {{STRIPE_SECRET_KEY}}",
  "Content-Type": "application/x-www-form-urlencoded",
  "User-Agent": "Famulor-MidCall-Stripe/1.0"
}

Content-Type wichtig: Stripe erwartet application/x-www-form-urlencoded, nicht JSON!

amount={amount}&currency={currency}&customer={customer_id}&description={description}&metadata[order_id]={order_id}&metadata[call_source]=mid_call_tool&metadata[customer_phone]={customer_phone}&automatic_payment_methods[enabled]=true

Parameter-Schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Betrag in kleinster Währungseinheit (z.B. 5000 für 50,00€)",
      "minimum": 50,
      "maximum": 9999999
    },
    "currency": {
      "type": "string",
      "enum": ["eur", "usd", "gbp", "chf", "dkk", "nok", "sek"],
      "description": "Währungscode (ISO 4217)",
      "default": "eur"
    },
    "customer_id": {
      "type": "string",
      "description": "Stripe Customer ID (falls vorhanden, z.B. 'cus_abc123')"
    },
    "description": {
      "type": "string",
      "description": "Zahlungsbeschreibung (erscheint auf Kreditkartenabrechnung)",
      "examples": ["Rechnung INV-2024-001", "Anzahlung Projekt XY", "Subscription Premium Plan"]
    },
    "order_id": {
      "type": "string",
      "description": "Deine interne Bestell- oder Rechnungs-ID"
    },
    "customer_phone": {
      "type": "string",
      "description": "Telefonnummer des Kunden (für Metadata)"
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "E-Mail-Adresse des Kunden (für Receipt und Follow-up)"
    },
    "payment_type": {
      "type": "string",
      "enum": ["one_time", "subscription", "installment"],
      "description": "Art der Zahlung",
      "default": "one_time"
    }
  },
  "required": ["amount", "currency", "description"]
}

Praktische Anwendungsszenarien

Szenario 1: Sofortige Anzahlung während Sales-Call

Payment-Bereitschaft erkennen

Sales-Conversation:
  Kunde: "Das Angebot klingt gut. Wie kann ich die Anzahlung leisten?"
  
KI-Assistant: "Perfekt! Ich bereite die Zahlung über 5.000€ vor..."

→ create_stripe_payment wird ausgelöst

Payment-Intent-Creation

Stripe-API-Call:
  amount: 500000  # 5.000€ in Cents
  currency: "eur"
  description: "Anzahlung Projekt CRM-Integration"
  customer_id: "cus_abc123def456"  # Falls bekannt
  order_id: "ORD-2024-001"
  
Stripe-Response:
  payment_intent_id: "pi_abc123def456ghi789"
  client_secret: "pi_abc123def456ghi789_secret_xyz"
  status: "requires_payment_method"

Payment-Link-Bereitstellung

KI-Integration:
  "Zahlung wurde vorbereitet. Ich sende Ihnen gleich einen sicheren 
   Payment-Link per E-Mail. Der Betrag ist 5.000€ für die Anzahlung 
   Ihres CRM-Integration-Projekts."

Follow-up-Actions:
  - E-Mail mit Stripe-Hosted-Checkout-Link
  - SMS mit Payment-Link als Fallback
  - CRM-Update: Payment-Intent erstellt
  - Sales-Team-Benachrichtigung

Szenario 2: Subscription-Upgrade

Plan-Upgrade während Support-Call

Subscription-Management:

Support-Context:
  Kunde: "Ich brauche mehr Features. Können wir das Upgrade sofort machen?"
  
Payment-Intent für Subscription:
  amount: 9900  # 99€/Monat
  currency: "eur"
  description: "Upgrade zu Professional Plan"
  metadata: {
    "subscription_type": "professional",
    "billing_cycle": "monthly",
    "upgrade_from": "basic",
    "effective_date": "2024-01-15"
  }

Integration-Workflow:
  1. Payment-Intent erstellen
  2. Customer zu Premium-Subscription-Gruppe
  3. Feature-Flags aktivieren nach erfolgreicher Zahlung
  4. Billing-System-Update

Installment-Payment-Plans

Ratenzahlung für große Projekte:

Enterprise-Deal-Context:
  Total: 50.000€ Enterprise-Lizenz
  Payment-Plan: 3 Raten à 16.667€
  
Payment-Intent-Serie:
  Rate 1 (sofort): amount: 1666700, description: "Rate 1/3 Enterprise-Lizenz"
  Rate 2 (+30 Tage): Scheduled Payment-Intent
  Rate 3 (+60 Tage): Scheduled Payment-Intent
  
Automation:
  - Erfolgreiche Rate 1 → Feature-Activation
  - Scheduled Rates → Automatic Follow-up-Calls
  - Payment-Failure → Account-Manager-Notification

Stripe Response-Verarbeitung

Erfolgreiche Payment-Intent-Creation

{
  "id": "pi_abc123def456ghi789",
  "object": "payment_intent",
  "amount": 500000,
  "currency": "eur",
  "status": "requires_payment_method",
  "customer": "cus_abc123def456",
  "description": "Anzahlung Projekt CRM-Integration",
  "client_secret": "pi_abc123def456ghi789_secret_xyz",
  "created": 1640995200,
  "metadata": {
    "order_id": "ORD-2024-001",
    "call_source": "mid_call_tool",
    "customer_phone": "+49123456789"
  },
  "next_action": {
    "type": "use_stripe_sdk"
  }
}

Natürliche Sprachintegration

Agent-Nachrichten vor Payment-Creation

Template: "Ich bereite die Zahlung über {{amount}} {{currency}} vor..."Kontextuelle Beispiele:

Einmalige Zahlung:
  "Ich bereite die Zahlung über 5.000 Euro vor..."

Subscription:
  "Ich richte Ihr monatliches Abo über 99 Euro ein..."

Anzahlung:
  "Ich erstelle den Payment-Link für Ihre Anzahlung von 2.500 Euro..."

Success-Kommunikation

Template: "Zahlung wurde vorbereitet. Payment Intent ID: {{response.id}}"Customer-friendly Varianten:

Mit E-Mail-Follow-up:
  "Zahlung wurde vorbereitet. Sie erhalten gleich eine E-Mail mit 
   dem sicheren Payment-Link für 5.000€."

Mit Security-Assurance:
  "Alle Zahlungsdaten werden sicher über Stripe verarbeitet - 
   wir speichern keine Kreditkarteninformationen."

Mit Next-Steps:
  "Payment-Link ist versandbereit. Nach der Zahlung aktivieren wir 
   sofort Ihre neuen Features."

Compliance & Sicherheit

PCI-DSS-Konformität

Sichere Payment-Handling

Best Practices:

Niemals Kreditkartendaten in Mid-call Actions
Nur Payment-Intent-Creation, kein Direct-Charging
Stripe-Hosted-Checkout für sichere Eingabe
PCI-Level-1-Compliance durch Stripe

DSGVO-Compliance

Datenschutz-Aspekte:

Minimale Metadata-Speicherung
Customer-Consent für Payment-Processing
Audit-Trail aller Payment-Aktivitäten
Right-to-Deletion für Payment-Metadaten

Webhook-Integration für Payment-Status

Stripe-Webhook-Events:
  payment_intent.succeeded:
    → Customer-Benachrichtigung: "Zahlung erhalten"
    → CRM-Update: Deal-Status "Paid"  
    → Service-Activation: Features freischalten
    → Team-Notification: Payment confirmed
  
  payment_intent.payment_failed:
    → Customer-Support-Notification
    → Retry-Payment-Link senden
    → Account-Manager-Alert
    → Alternative Payment-Methods anbieten
  
  payment_intent.canceled:
    → Deal-Status auf "Payment-Canceled"
    → Follow-up-Task für Sales-Team
    → Customer-Retention-Workflow starten

Advanced Stripe Features

Subscription-Management

Subscription-Creation via Mid-Call

Subscription-Workflow:
  
Payment-Intent für Recurring-Payments:
  amount: 9900  # 99€/Monat
  currency: "eur"
  setup_future_usage: "off_session"  # Für wiederkehrende Zahlungen
  metadata: {
    "subscription_plan": "professional",
    "billing_interval": "monthly"
  }

Customer-Communication:
  "Ihr Professional-Abo für 99€ monatlich wird eingerichtet. 
   Nach der ersten Zahlung aktivieren wir alle Premium-Features."

Invoice-Payment-Integration

Invoice-based-Payments:
  
Für B2B-Kunden:
  - Payment-Intent mit payment_method_types: ["sepa_debit"]
  - Automatische Invoice-Generation
  - NET-30-Payment-Terms
  
Customer-Experience:
  "Für Ihr Unternehmen richten wir Rechnung mit 30 Tagen Zahlungsziel ein. 
   Sie erhalten die Rechnung per E-Mail."

Zahlungs-Sicherheit: Verwende niemals Stripe-Secret-Keys in Frontend-Code. Mid-call Actions laufen Server-seitig und sind damit sicher für Secret-Key-Usage.

Payment-Tipp: Kombiniere Stripe-Payment-Intents mit CRM-Integration für vollständige Payment-to-Revenue-Attribution. Dies ermöglicht präzises ROI-Tracking von Mid-Call-Sales-Conversions.

Passende Seiten: Introduction und Building Flows und Debugging Runs.

Statt einzelner HTTP-Aktionen ein ganzes Toolset auf einmal? Externen MCP-Server verbinden — Tools werden automatisch erkannt. Siehe MCP-Server.

Mid-Call-Tools

Mid-Call-Tools Integrationen

Stripe Integration

Stripe Integration Template

Überblick & Funktionen

Payment-Intent-Management

Customer & Order-Integration

Stripe Account & API Setup

1. Stripe Dashboard vorbereiten

Payment-Intent-Tool konfigurieren

Konfiguration im Famulor Interface

Parameter-Schema

Praktische Anwendungsszenarien

Szenario 1: Sofortige Anzahlung während Sales-Call

Szenario 2: Subscription-Upgrade

Stripe Response-Verarbeitung

Erfolgreiche Payment-Intent-Creation

Natürliche Sprachintegration

Compliance & Sicherheit

PCI-DSS-Konformität

Sichere Payment-Handling

DSGVO-Compliance

Webhook-Integration für Payment-Status

Advanced Stripe Features

Subscription-Management

​Stripe Integration Template

​Überblick & Funktionen

Payment-Intent-Management

Customer & Order-Integration

​Stripe Account & API Setup

​1. Stripe Dashboard vorbereiten

​Payment-Intent-Tool konfigurieren

​Konfiguration im Famulor Interface

​Parameter-Schema

​Praktische Anwendungsszenarien

​Szenario 1: Sofortige Anzahlung während Sales-Call

​Szenario 2: Subscription-Upgrade

​Stripe Response-Verarbeitung

​Erfolgreiche Payment-Intent-Creation

​Natürliche Sprachintegration

​Compliance & Sicherheit

​PCI-DSS-Konformität

Sichere Payment-Handling

DSGVO-Compliance

​Webhook-Integration für Payment-Status

​Advanced Stripe Features

​Subscription-Management

Stripe Integration Template

Überblick & Funktionen

Stripe Account & API Setup

1. Stripe Dashboard vorbereiten

Payment-Intent-Tool konfigurieren

Konfiguration im Famulor Interface

Parameter-Schema

Praktische Anwendungsszenarien

Szenario 1: Sofortige Anzahlung während Sales-Call

Szenario 2: Subscription-Upgrade

Stripe Response-Verarbeitung

Erfolgreiche Payment-Intent-Creation

Natürliche Sprachintegration

Compliance & Sicherheit

PCI-DSS-Konformität

Webhook-Integration für Payment-Status

Advanced Stripe Features

Subscription-Management