​
Stripe Integration Template

Integrieren Sie Stripe-Payment-Processing in Ihre Mid-Call-Tools und ermöglichen Sie es Ihrem 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

1

Stripe Account einrichten

  • Registrieren Sie sich bei Stripe oder loggen Sie sich ein
  • Vervollständigen Sie Ihr Business-Profil für Live-Zahlungen
  • Aktivieren Sie relevante Payment-Methods (Karten, SEPA, etc.)
2

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-Tools benötigt:
  - Secret Key (für Server-to-Server API-Calls)
  - Test-Environment: sk_test_...
  - Production: sk_live_...
3

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
4

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

FeldWert
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. Verwenden Sie dies, wenn ein Kunde bereit ist zu bezahlen oder eine Anzahlung leisten möchte.”
HTTP-MethodePOST
Timeout (ms)5000
Endpoint*https://api.stripe.com/v1/payment_intents

​
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": "Ihre 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

1

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
2

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"
3

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

​
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

​
Compliance & Sicherheit

​
PCI-DSS-Konformität

Sichere Payment-Handling

Best Practices:
  • Niemals Kreditkartendaten in Mid-Call-Tools
  • 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

Zahlungs-Sicherheit: Verwenden Sie niemals Stripe-Secret-Keys in Frontend-Code. Mid-Call-Tools laufen Server-seitig und sind damit sicher für Secret-Key-Usage.
Payment-Tipp: Kombinieren Sie 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.