ComposioHQ/Braintree-Automation

Braintree Automation

Automatisieren Sie Zahlungsabwicklungen über Stripe-kompatible Tools, einschließlich der Verwaltung von Kunden, Abonnements, Zahlungsmethoden, Kontotransaktionen und Kundensuchen. Die Composio-Plattform leitet Braintree-Zahlungsworkflows durch das Stripe-Toolkit für eine einheitliche Zahlungsverwaltung.

Toolkit-Dokumentation: composio.dev/toolkits/braintree

---

Einrichtung

Diese Fähigkeit benötigt den Rube MCP Server, der unter https://rube.app/mcp verbunden ist.

Stellen Sie vor der Ausführung von Tools sicher, dass eine aktive Verbindung für das stripe-Toolkit besteht. Wenn keine Verbindung aktiv ist, initiieren Sie eine über RUBE_MANAGE_CONNECTIONS.

---

Kernworkflows

1. Kunden erstellen und verwalten

Erstellen Sie neue Kunden und rufen Sie Details vorhandener Kunden ab.

Tools:

• STRIPE_CREATE_CUSTOMER – Neuen Kunden erstellen
• STRIPE_GET_CUSTOMERS_CUSTOMER – Kunden nach ID abrufen
• STRIPE_POST_CUSTOMERS_CUSTOMER – Vorhandenen Kunden aktualisieren
• STRIPE_LIST_CUSTOMERS – Kunden mit Paginierung auflisten
• STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS – Kunden nach E-Mail, Name, Metadaten durchsuchen

Wichtige Parameter für STRIPE_CREATE_CUSTOMER:

• email – Primäre E-Mail-Adresse des Kunden
• name – Vollständiger Name oder Firmenname
• phone – Telefonnummer mit Ländervorwahl
• description – Interne Referenznotizen
• address – Rechnungsadressobjekt mit line1, city, state, postal_code, country

Wichtige Parameter für STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS:

• query (erforderlich) – Stripe-Suchabfragesprache. Muss die Syntax feld:wert verwenden:
  • email:'[email protected]' – Exakte Übereinstimmung (Groß-/Kleinschreibung nicht beachtet)
  • name~'Max' – Teilzeichenfolgensuche (mind. 3 Zeichen)
  • metadata['schlüssel']:'wert' – Metadatensuche
  • created>1609459200 – Zeitstempelvergleich
  • Kombinieren mit AND oder OR (max. 10 Klauseln, nicht mischbar)
• limit – Ergebnisse pro Seite (1–100, Standard 10)

Beispiel:

Tool: STRIPE_CREATE_CUSTOMER
Argumente:
  email: "[email protected]"
  name: "Jane Doe"
  description: "Enterprise-Kunde"
  address: {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }

---

2. Abonnements verwalten

Erstellen Sie Abonnements und zeigen Sie Details zu Kundenabonnements an.

Tools:

• STRIPE_CREATE_SUBSCRIPTION – Neues Abonnement für einen vorhandenen Kunden erstellen
• STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS – Alle Abonnements eines Kunden auflisten
• STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID – Ein bestimmtes Abonnement abrufen

Wichtige Parameter für STRIPE_CREATE_SUBSCRIPTION:

• customer (erforderlich) – Kunden-ID, z. B. "cus_xxxxxxxxxxxxxx"
• items (erforderlich) – Array von Abonnementpositionen, jede mit:
  • price – Preis-ID, z. B. "price_xxxxxxxxxxxxxx" (entweder dies ODER price_data verwenden)
  • price_data – Inline-Preisdefinition mit currency, product, unit_amount, recurring
  • quantity – Positionsmenge
• default_payment_method – Zahlungsmethoden-ID (nicht erforderlich bei Testphasen oder Rechnungsstellung)
• trial_period_days – Testtage (keine Zahlung während Testphase erforderlich)
• collection_method – "charge_automatically" (Standard) oder "send_invoice"
• cancel_at_period_end – Am Ende des Abrechnungszeitraums kündigen (boolesch)

Wichtige Parameter für STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS:

• customer (erforderlich) – Kunden-ID
• status – Filter: "active", "all", "canceled", "trialing", "past_due" usw.
• limit – Ergebnisse pro Seite (1–100, Standard 10)

Beispiel:

Tool: STRIPE_CREATE_SUBSCRIPTION
Argumente:
  customer: "cus_abc123"
  items: [{"price": "price_xyz789", "quantity": 1}]
  trial_period_days: 14

---

3. Zahlungsmethoden verwalten

Listen Sie Zahlungsmethoden auf und weisen Sie sie Kunden zu.

Tools:

• STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS – Zahlungsmethoden eines Kunden auflisten
• STRIPE_ATTACH_PAYMENT_METHOD – Zahlungsmethode einem Kunden zuweisen

Wichtige Parameter für STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS:

• customer (erforderlich) – Kunden-ID
• type – Nach Typ filtern: "card", "sepa_debit", "us_bank_account" usw.
• limit – Ergebnisse pro Seite (1–100, Standard 10)

Beispiel:

Tool: STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS
Argumente:
  customer: "cus_abc123"
  type: "card"
  limit: 10

---

4. Kontotransaktionen anzeigen

Rufen Sie den Verlauf der Kontostandsänderungen für einen Kunden ab.

Tool: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS

Wichtige Parameter:

• customer (erforderlich) – Kunden-ID
• created – Nach Erstellungsdatum mit Vergleichsoperatoren filtern: {"gte": 1609459200} oder {"gt": 1609459200, "lt": 1640995200}
• invoice – Nach zugehöriger Rechnungs-ID filtern
• limit – Ergebnisse pro Seite (1–100)
• starting_after / ending_before – Paginierungscursor

Beispiel:

Tool: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS
Argumente:
  customer: "cus_abc123"
  limit: 25
  created: {"gte": 1704067200}

---

Bekannte Fallstricke

Fallstrick	Detail
Suchabfragesyntax	STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS erfordert feldpräfixierte Abfragen (z. B. email:'x'). Bloße Zeichenfolgen ohne Feldpräfix sind ungültig und führen zu einem Fehler.
Zahlungsmethode bei Abonnement	default_payment_method ist nicht erforderlich, wenn trial_period_days oder collection_method='send_invoice' verwendet wird. Andernfalls kann die Aktivierung des Abonnements fehlschlagen.
Zuweisung einer Zahlungsmethode	Eine PaymentMethod muss sich in einem gelösten Zustand befinden, bevor sie einem Kunden zugewiesen wird. Bereits zugewiesene Methoden verursachen einen Fehler.
Paginierungscursor	Verwenden Sie starting_after/ending_before mit Objekt-IDs, nicht mit Seitennummern. Extrahieren Sie die erste/letzte Objekt-ID aus jeder Antwort.
Beträge in Cent	Alle Geldbeträge sind in der kleinsten Währungseinheit (z. B. Cent für USD). 1000 = 10,00 $
Standardstatus für Abonnements	GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS schließt standardmäßig gekündigte Abonnements aus. Übergeben Sie status: "all", um sie einzuschließen.

---

Schnellübersicht

Tool-Slug	Beschreibung
STRIPE_CREATE_CUSTOMER	Neuen Kunden erstellen
STRIPE_GET_CUSTOMERS_CUSTOMER	Kunden nach ID abrufen
STRIPE_POST_CUSTOMERS_CUSTOMER	Vorhandenen Kunden aktualisieren
STRIPE_LIST_CUSTOMERS	Kunden mit Paginierung auflisten
STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS	Kunden nach Attributen durchsuchen
STRIPE_CREATE_SUBSCRIPTION	Abonnement für einen Kunden erstellen
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS	Kundenabonnements auflisten
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID	Bestimmtes Abonnement abrufen
STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS	Zahlungsmethoden eines Kunden auflisten
STRIPE_ATTACH_PAYMENT_METHOD	Zahlungsmethode einem Kunden zuweisen
STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS	Kontotransaktionen eines Kunden auflisten

---

Bereitgestellt von Composio