Automação Braintree

O que Automação Braintree faz?

Automatize operações de processamento de pagamentos usando ferramentas compatíveis com Stripe, incluindo gerenciamento de clientes, assinaturas, métodos de pagamento, transações de saldo e pesquisas de clientes. A plataforma Composio roteia fluxos de trabalho de pagamento Braintree através do toolkit Stripe para um gerenciamento unificado de pagamentos.

Documentação do toolkit: composio.dev/toolkits/braintree

---

Configuração

Esta skill requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que existe uma conexão ativa para o toolkit stripe. Se nenhuma conexão estiver ativa, inicie uma via RUBE_MANAGE_CONNECTIONS.

---

Fluxos de Trabalho Principais

1. Criar e Gerenciar Clientes

Crie novos clientes e recupere detalhes de clientes existentes.

Ferramentas:

• STRIPE_CREATE_CUSTOMER -- Criar um novo cliente
• STRIPE_GET_CUSTOMERS_CUSTOMER -- Recuperar um cliente por ID
• STRIPE_POST_CUSTOMERS_CUSTOMER -- Atualizar um cliente existente
• STRIPE_LIST_CUSTOMERS -- Listar clientes com paginação
• STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS -- Pesquisar clientes por email, nome, metadados

Parâmetros-chave para STRIPE_CREATE_CUSTOMER:

• email -- Endereço de email principal do cliente
• name -- Nome completo ou nome da empresa
• phone -- Número de telefone com código do país
• description -- Notas de referência interna
• address -- Objeto de endereço de cobrança com line1, city, state, postal_code, country

Parâmetros-chave para STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS:

• query (obrigatório) -- Linguagem de consulta de pesquisa Stripe. Deve usar a sintaxe campo:valor:
  • email:'[email protected]' -- Correspondência exata (insensível a maiúsculas/minúsculas)
  • name~'João' -- Correspondência de substring (mín. 3 caracteres)
  • metadata['chave']:'valor' -- Pesquisa por metadados
  • created>1609459200 -- Comparação de timestamp
  • Combine com AND ou OR (máx. 10 cláusulas, não pode misturar)
• limit -- Resultados por página (1--100, padrão 10)

Exemplo:

Ferramenta: STRIPE_CREATE_CUSTOMER
Argumentos:
  email: "[email protected]"
  name: "Jane Doe"
  description: "Cliente plano Enterprise"
  address: {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }

---

2. Gerenciar Assinaturas

Crie assinaturas e visualize detalhes de assinaturas de clientes.

Ferramentas:

• STRIPE_CREATE_SUBSCRIPTION -- Criar uma nova assinatura para um cliente existente
• STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS -- Listar todas as assinaturas de um cliente
• STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID -- Obter uma assinatura específica

Parâmetros-chave para STRIPE_CREATE_SUBSCRIPTION:

• customer (obrigatório) -- ID do cliente, ex.: "cus_xxxxxxxxxxxxxx"
• items (obrigatório) -- Array de itens de assinatura, cada um com:
  • price -- ID do preço, ex.: "price_xxxxxxxxxxxxxx" (use este OU price_data)
  • price_data -- Definição de preço inline com currency, product, unit_amount, recurring
  • quantity -- Quantidade do item
• default_payment_method -- ID do método de pagamento (não obrigatório para períodos de teste ou faturamento por invoice)
• trial_period_days -- Dias de teste (sem pagamento durante o teste)
• collection_method -- "charge_automatically" (padrão) ou "send_invoice"
• cancel_at_period_end -- Cancelar no final do período de faturamento (booleano)

Parâmetros-chave para STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS:

• customer (obrigatório) -- ID do cliente
• status -- Filtrar por: "active", "all", "canceled", "trialing", "past_due", etc.
• limit -- Resultados por página (1--100, padrão 10)

Exemplo:

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

---

3. Gerenciar Métodos de Pagamento

Liste e anexe métodos de pagamento a clientes.

Ferramentas:

• STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS -- Listar métodos de pagamento de um cliente
• STRIPE_ATTACH_PAYMENT_METHOD -- Anexar um método de pagamento a um cliente

Parâmetros-chave para STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS:

• customer (obrigatório) -- ID do cliente
• type -- Filtrar por tipo: "card", "sepa_debit", "us_bank_account", etc.
• limit -- Resultados por página (1--100, padrão 10)

Exemplo:

Ferramenta: STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS
Argumentos:
  customer: "cus_abc123"
  type: "card"
  limit: 10

---

4. Visualizar Transações de Saldo

Recupere o histórico de alterações de saldo de um cliente.

Ferramenta: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS

Parâmetros-chave:

• customer (obrigatório) -- ID do cliente
• created -- Filtrar por data de criação com operadores de comparação: {"gte": 1609459200} ou {"gt": 1609459200, "lt": 1640995200}
• invoice -- Filtrar por ID de fatura relacionada
• limit -- Resultados por página (1--100)
• starting_after / ending_before -- Cursores de paginação

Exemplo:

Ferramenta: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS
Argumentos:
  customer: "cus_abc123"
  limit: 25
  created: {"gte": 1704067200}

---

Armadilhas Conhecidas

Armadilha	Detalhe
Sintaxe de consulta de pesquisa	STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS requer consultas com prefixo de campo (ex.: email:'x'). Strings simples sem prefixo de campo são inválidas e gerarão erro.
Método de pagamento da assinatura	default_payment_method não é obrigatório se estiver usando trial_period_days ou collection_method='send_invoice'. Caso contrário, a assinatura pode falhar ao ser ativada.
Anexação de método de pagamento	Um PaymentMethod deve estar em estado desanexado antes de ser anexado a um cliente. Métodos já anexados gerarão erro.
Cursores de paginação	Use starting_after/ending_before com IDs de objeto, não números de página. Extraia o ID do último/primeiro objeto de cada resposta.
Valores de saldo em centavos	Todos os valores monetários estão na menor unidade da moeda (ex.: centavos para USD). 1000 = $10,00.
Status padrão da assinatura	GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS exclui assinaturas canceladas por padrão. Passe status: "all" para incluí-las.

---

Referência Rápida

Slug da Ferramenta	Descrição
STRIPE_CREATE_CUSTOMER	Criar um novo cliente
STRIPE_GET_CUSTOMERS_CUSTOMER	Recuperar um cliente por ID
STRIPE_POST_CUSTOMERS_CUSTOMER	Atualizar um cliente existente
STRIPE_LIST_CUSTOMERS	Listar clientes com paginação
STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS	Pesquisar clientes por atributos
STRIPE_CREATE_SUBSCRIPTION	Criar uma assinatura para um cliente
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS	Listar assinaturas de um cliente
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID	Obter uma assinatura específica
STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS	Listar métodos de pagamento de um cliente
STRIPE_ATTACH_PAYMENT_METHOD	Anexar método de pagamento a um cliente
STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS	Listar transações de saldo de um cliente

---

Desenvolvido por Composio