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

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