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

Braintree Automation

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

Braintree Automation

让 AI 帮你安装

Braintree Automation

Setup

Core Workflows

1. Create and Manage Customers

2. Manage Subscriptions

3. Manage Payment Methods

4. View Balance Transactions

Known Pitfalls

Quick Reference

链接

创作者

Braintree Automation

Setup

Core Workflows

1. Create and Manage Customers

2. Manage Subscriptions

3. Manage Payment Methods

4. View Balance Transactions

Known Pitfalls

Quick Reference