braintree-automation

# Braintree Automation Automate payment processing operations via Stripe-compatible tooling including managing customers, subscriptions, payment methods, balance transactions, and customer searches. The Composio platform routes Braintree payment workflows through the Stripe toolkit for unified payment management. **Toolkit docs:** [composio.dev/toolkits/braintree](https://composio.dev/toolkits/braintree) --- ## Setup This skill requires the **Rube MCP server** connected at `https://rube.app/mcp`. Before executing any tools, ensure an active connection exists for the `stripe` toolkit. If no connection is active, initiate one via `RUBE_MANAGE_CONNECTIONS`. --- ## Core Workflows ### 1. Create and Manage Customers Create new customers and retrieve existing customer details. **Tools:** - `STRIPE_CREATE_CUSTOMER` -- Create a new customer - `STRIPE_GET_CUSTOMERS_CUSTOMER` -- Retrieve a customer by ID - `STRIPE_POST_CUSTOMERS_CUSTOMER` -- Update an existing customer - `STRIPE_LIST_CUSTOMERS` -- List customers with pagination - `STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS` -- Search customers by email, name, metadata **Key Parameters for `STRIPE_CREATE_CUSTOMER`:** - `email` -- Customer's primary email address - `name` -- Full name or business name - `phone` -- Phone number with country code - `description` -- Internal reference notes - `address` -- Billing address object with `line1`, `city`, `state`, `postal_code`, `country` **Key Parameters for `STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS`:** - `query` (required) -- Stripe Search Query Language. Must use `field:value` syntax: - `email:'user@example.com'` -- Exact match (case insensitive) - `name~'John'` -- Substring match (min 3 chars) - `metadata['key']:'value'` -- Metadata search - `created>1609459200` -- Timestamp comparison - Combine with `AND` or `OR` (max 10 clauses, cannot mix) - `limit` -- Results per page (1--100, default 10) **Example:** ``` Tool: STRIPE_CREATE_CUSTOMER Arguments: email: "jane@example.com" name: "Jane Doe" description: "Enterprise plan customer" address: { "line1": "123 Main St", "city": "San Francisco", "state": "CA", "postal_code": "94105", "country": "US" } ``` --- ### 2. Manage Subscriptions Create subscriptions and view customer subscription details. **Tools:** - `STRIPE_CREATE_SUBSCRIPTION` -- Create a new subscription for an existing customer - `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` -- List all subscriptions for a customer - `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` -- Get a specific subscription **Key Parameters for `STRIPE_CREATE_SUBSCRIPTION`:** - `customer` (required) -- Customer ID, e.g., `"cus_xxxxxxxxxxxxxx"` - `items` (required) -- Array of subscription items, each with: - `price` -- Price ID, e.g., `"price_xxxxxxxxxxxxxx"` (use this OR `price_data`) - `price_data` -- Inline price definition with `currency`, `product`, `unit_amount`, `recurring` - `quantity` -- Item quantity - `default_payment_method` -- Payment method ID (not required for trials or invoice billing) - `trial_period_days` -- Trial days (no payment required during trial) - `collection_method` -- `"charge_automatically"` (default) or `"send_invoice"` - `cancel_at_period_end` -- Cancel at end of billing period (boolean) **Key Parameters for `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS`:** - `customer` (required) -- Customer ID - `status` -- Filter: `"active"`, `"all"`, `"canceled"`, `"trialing"`, `"past_due"`, etc. - `limit` -- Results per page (1--100, default 10) **Example:** ``` Tool: STRIPE_CREATE_SUBSCRIPTION Arguments: customer: "cus_abc123" items: [{"price": "price_xyz789", "quantity": 1}] trial_period_days: 14 ``` --- ### 3. Manage Payment Methods List and attach payment methods to customers. **Tools:** - `STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS` -- List a customer's payment methods - `STRIPE_ATTACH_PAYMENT_METHOD` -- Attach a payment method to a customer **Key Parameters for `STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS`:** - `customer` (required) -- Customer ID - `type` -- Filter by type: `"card"`, `"sepa_debit"`, `"us_bank_account"`, etc. - `limit` -- Results per page (1--100, default 10) **Example:** ``` Tool: STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS Arguments: customer: "cus_abc123" type: "card" limit: 10 ``` --- ### 4. View Balance Transactions Retrieve the history of balance changes for a customer. **Tool:** `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS` **Key Parameters:** - `customer` (required) -- Customer ID - `created` -- Filter by creation date with comparison operators: `{"gte": 1609459200}` or `{"gt": 1609459200, "lt": 1640995200}` - `invoice` -- Filter by related invoice ID - `limit` -- Results per page (1--100) - `starting_after` / `ending_before` -- Pagination cursors **Example:** ``` Tool: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS Arguments: customer: "cus_abc123" limit: 25 created: {"gte": 1704067200} ``` --- ## Known Pitfalls | Pitfall | Detail | |---------|--------| | **Search query syntax** | `STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS` requires field-prefixed queries (e.g., `email:'x'`). Bare strings without field prefixes are invalid and will error. | | **Subscription payment method** | `default_payment_method` is not required if using `trial_period_days` or `collection_method='send_invoice'`. Otherwise, the subscription may fail to activate. | | **Payment method attachment** | A `PaymentMethod` must be in a detached state before attaching to a customer. Already-attached methods will error. | | **Pagination cursors** | Use `starting_after`/`ending_before` with object IDs, not page numbers. Extract the last/first object ID from each response. | | **Balance amounts in cents** | All monetary amounts are in the smallest currency unit (e.g., cents for USD). 1000 = $10.00. | | **Subscription status default** | `GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` excludes canceled subscriptions by default. Pass `status: "all"` to include them. | --- ## Quick Reference | Tool Slug | Description | |-----------|-------------| | `STRIPE_CREATE_CUSTOMER` | Create a new customer | | `STRIPE_GET_CUSTOMERS_CUSTOMER` | Retrieve a customer by ID | | `STRIPE_POST_CUSTOMERS_CUSTOMER` | Update an existing customer | | `STRIPE_LIST_CUSTOMERS` | List customers with pagination | | `STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS` | Search customers by attributes | | `STRIPE_CREATE_SUBSCRIPTION` | Create a subscription for a customer | | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` | List customer subscriptions | | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` | Get a specific subscription | | `STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS` | List customer payment methods | | `STRIPE_ATTACH_PAYMENT_METHOD` | Attach payment method to customer | | `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS` | List customer balance transactions | --- *Powered by [Composio](https://composio.dev)*