# Stripe + Brew

Sincronize os clientes do Stripe com o público da marca, dispare automações a partir de 22 eventos do Stripe e lance e-mails de ciclo de vida prontos (boas-vindas, fim do período de teste, recuperação de pagamento com falha, reconquista).

URL canônica: https://brew.new/pt-br/browse/integrations/stripe

- Direção: Entrada de dados
- Conexão: OAuth
- Sincronização de clientes + gatilhos de evento

## Funcionalidades disponíveis

- **Gatilhos de evento**: Dispare automações do Brew a partir de 22 eventos do Stripe que cobrem assinaturas, faturas, checkouts, orçamentos, cobranças, reembolsos e intenções de pagamento.
- **Sincronizar contatos**: Sincronize os clientes do Stripe com o público da marca, com os campos personalizados `stripe_*` disponíveis como atributos filtráveis.
- **Importação de clientes em massa**: Traga todos os clientes do Stripe para a marca ativa em um clique. Retomável e durável, via Vercel Workflow.
- **Modelos de e-mail de ciclo de vida**: Modelos iniciais de boas-vindas, fim do período de teste, recuperação de pagamento com falha e reconquista.

## Transforme eventos de cobrança em e-mails úteis

Conecte o Stripe via OAuth para disparar e-mails com a cara da sua marca quando uma assinatura começa, um período de teste está perto do fim ou o pagamento de uma fatura falha. O Brew registra o webhook e disponibiliza os eventos compatíveis como gatilhos de automação.

O Stripe continua responsável por pagamentos, novas tentativas de cobrança, reembolsos e mudanças de assinatura. O Brew cria e envia os e-mails.


## O que você pode criar

- Lembretes de fim do período de teste: use o evento customer.subscription.trial_will_end para explicar o que acontece em seguida e incluir um link para a sua página de planos ou de cobrança.
- Avisos de pagamento com falha: use o evento invoice.payment_failed para enviar um aviso no momento certo, com um link para a sua própria página de cobrança. Alinhe esse envio com os e-mails que o Stripe manda aos clientes, para que o mesmo aviso não saia duas vezes.
- E-mails de boas-vindas para assinantes: comece a partir do evento customer.subscription.created ou do checkout.session.completed, escolhendo um único gatilho para evitar boas-vindas duplicadas.
- E-mails de mudança de plano: o evento customer.subscription.updated pode fornecer os campos previousPlan e newPlan, quando os inclui.
- Confirmações de pagamento: o evento invoice.paid é disparado quando uma fatura é paga. Use amount, currency e invoiceNumber como tags de mesclagem.
- Avisos de renovação: o evento invoice.upcoming é disparado antes de o Stripe criar a próxima fatura de uma assinatura e traz amount e currency. O payload dele não tem a data de renovação, então inclua um link para a sua página de cobrança com os detalhes.
- E-mails pós-cancelamento: o evento customer.subscription.deleted é disparado quando uma assinatura é cancelada ou excluída. Uma nova assinatura não interrompe uma execução que já está em andamento, então adicione uma condição no campo contact.stripe_subscription_status antes de cada e-mail seguinte.
- Avisos de pausa e retomada: com os eventos customer.subscription.paused e customer.subscription.resumed, confirme a mudança ao assinante.
- Resultados de pagamentos com confirmação posterior: os eventos checkout.session.async_payment_succeeded e checkout.session.async_payment_failed informam como terminou, depois do checkout, um pagamento feito com um método de confirmação posterior. paymentStatus e sessionMode ficam disponíveis como tags de mesclagem.
- Lembretes de checkout abandonado: o Brew não tem um gatilho para sessões do Checkout que expiraram. Dispare o seu próprio evento personalizado quando a sua aplicação perceber que uma sessão expirou.
- Confirmações de reembolso: o evento refund.created traz refundAmount, refundCurrency, refundReason e refundStatus do reembolso em questão. O evento charge.refunded traz só os totais da cobrança, como amountRefunded.
- Acompanhamento de orçamentos: os eventos quote.finalized, quote.accepted e quote.canceled trazem o valor, a moeda e o status do orçamento. Não há um campo com o link do orçamento, então direcione o comprador para a sua própria página.
- Falhas em pagamentos únicos: o evento payment_intent.payment_failed traz failureCode, failureMessage e declineCode, para que o e-mail possa explicar por que o pagamento falhou.

## Um lembrete de pagamento com falha que confere o estado atual

Comece com um e-mail disparado pelo evento invoice.payment_failed. Para um lembrete posterior, faça a sua aplicação agendar uma nova verificação do status da fatura no Stripe. Dispare um evento personalizado separado no Brew só se a fatura continuar em aberto e o cliente ainda for elegível.

Depois de uma etapa Aguardar, os campos do evento ainda contêm o payload original do evento. Uma condição no campo contact.stripe_subscription_status lê o valor atual desse campo no contato do Brew quando aquele nó é executado. Ela não consulta o Stripe nem comprova que uma fatura específica foi paga. Atualizações do contato e novos eventos de pagamento não cancelam automaticamente uma execução anterior. Atualizar o cartão também não é prova de pagamento.

Teste os dois caminhos: um cliente com a fatura ainda em aberto, e que continua elegível, recebe o lembrete; um cliente que paga antes da verificação agendada não recebe. Teste as novas tentativas com o contrato de idempotência documentado.


## Configure o Stripe no Brew

- Abra Integrações, escolha Stripe e selecione Conectar. Autorize o acesso pelo OAuth do Stripe.
- O Brew provisiona o webhook e os 22 tipos de evento compatíveis. Não há um botão para ativar ou desativar eventos.
- Para importar os clientes que você já tem, abra a aba Gerenciar e escolha Sincronizar clientes do Stripe. Um registro de cliente, por si só, não estabelece consentimento para e-mails de marketing.
- Crie uma automação e selecione o evento do Stripe dela. Revise o destinatário, os campos do payload, o conteúdo do e-mail e os links de cobrança.
- O Brew conecta contas do Stripe no modo de produção, e os eventos do modo de teste não sincronizam contatos nem iniciam automações. Mantenha a automação como rascunho e teste com destinatários controlados antes de publicar. Só automações ativas são executadas quando chega um evento correspondente.
- Um agente pode criar, testar e publicar automações pelo MCP do Brew ou pela API, depois que uma pessoa autorizada conectar a conta do Stripe no app.

## Eventos do Stripe compatíveis

O Brew é compatível com estes 22 tipos de evento:

- checkout.session.async_payment_succeeded
- checkout.session.async_payment_failed
- checkout.session.completed
- customer.created
- customer.updated
- customer.deleted
- customer.subscription.created
- customer.subscription.updated
- customer.subscription.paused
- customer.subscription.resumed
- customer.subscription.trial_will_end
- customer.subscription.deleted
- invoice.created
- invoice.paid
- invoice.payment_failed
- invoice.upcoming
- quote.finalized
- quote.accepted
- quote.canceled
- charge.refunded
- refund.created
- payment_intent.payment_failed

## Sincronização de clientes e personalização

Eventos de clientes e de assinaturas podem atualizar os contatos do Brew com o contexto de cobrança. Os campos de contato disponíveis incluem stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end e stripe_delinquent. A disponibilidade depende do evento do Stripe e dos dados recebidos.

Use o esquema de payload declarado do evento selecionado para as tags de mesclagem. Dependendo do evento, os campos incluem firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan e failureMessage. Os valores monetários ficam em centavos quando o esquema indica centavos.

Os identificadores de objetos do Stripe são removidos dos payloads das automações. Não presuma que IDs de faturas ou de assinaturas podem ser usados como tags de mesclagem. O Brew também não guarda o ID de cliente do Stripe no contato.

A opção Sincronizar nome completo, definida em cada evento, controla se o Stripe pode atualizar o nome do contato. Ela não ativa nem desativa um gatilho.


## Posso interromper um lembrete depois que o cliente paga?

Um evento de pagamento posterior não cancela automaticamente uma execução iniciada por uma falha anterior. Agende uma verificação do lado da aplicação antes do lembrete e dispare um novo evento só enquanto a fatura continuar em aberto.


## Por que um evento aparece sem que um e-mail seja enviado?

Receber um evento e enviar um e-mail são etapas separadas. Confirme que uma automação correspondente está ativa, examine os filtros e o histórico de execuções dela e verifique a elegibilidade do destinatário e o domínio de envio. A opção Sincronizar nome completo só controla as atualizações de nome.


## Limites e solução de problemas

- O Brew não pode criar cobranças, emitir reembolsos nem alterar assinaturas do Stripe.
- Se um evento aparece na aba Eventos, em Gerenciar, mas nenhum e-mail chega, verifique se a automação vinculada está ativa, os filtros e o histórico de execuções dela, o destinatário e se o domínio de envio está pronto.
- Se os erros de assinatura do webhook persistirem, reconecte o Stripe para provisionar um novo segredo de webhook.
- Use o evento refund.created quando o e-mail precisar de campos específicos de reembolso; confirme os campos disponíveis no esquema do gatilho.
- Revise o consentimento e a finalidade de cada e-mail. Importar contatos de cobrança não autoriza envios promocionais.

## Fontes e guias de configuração

- [Monte um fluxo de e-mails de ciclo de vida com o Stripe](/pt-br/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events)
- [Compare integrações de e-mail com o Stripe](/pt-br/blog/best-email-marketing-tools-with-stripe-integration-subscription-events-and-automation-compared)
- [Guia de configuração do Stripe](https://docs.brew.new/integrations/import/stripe)
- [Crie uma automação](https://docs.brew.new/create-emails/build-an-automation)
- [Tags de mesclagem](https://docs.brew.new/create-emails/merge-tags)
- [Referência de eventos do Stripe](https://docs.stripe.com/api/events/types)
- [Configurações de e-mails para clientes do Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails)

## Relacionados

- [Todas as integrações](https://brew.new/pt-br/browse/integrations.md)
- [Criar conta](https://brew.new/pt-br/sign-up.md)
- Site: https://brew.new