Primeiros passos com o Stripe

O que você vai aprender

Saiba como integrar o Stripe ao Klaviyo para personalizar e direcionar e-mails com base nos dados de fatura e pagamento de seus clientes.

O senhor configurará a integração do Stripe em duas etapas. Primeiro, o senhor conectará o Stripe ativando a integração no Klaviyo. Em seguida, o senhor configura webhooks no Stripe que permitirão a sincronização em tempo real de dados específicos do Stripe com o Klaviyo.

Aqui está uma visão geral dos dados que sincronizamos do Stripe:

• Quando uma fatura é emitida e os itens incluídos em cada fatura
• Informações de pagamento para quando um usuário falha no pagamento, é reembolsado ou paga com sucesso

Habilitar a integração do Stripe no Klaviyo

1. No Klaviyo, clique no nome da sua conta no canto inferior esquerdo e selecione Integrations (Integrações).
2. Selecione Add integrations (Adicionar integrações), procure o Stripe e clique no cartão. 
3. Em seguida, clique em Install (Instalar).
4. Clique em Connect to Stripe (Conectar ao Stripe). Isso o levará ao site do Stripe - faça login, se necessário.
5. Selecione a conta Stripe que deseja conectar ao Klaviyo e clique em Connect (Conectar). 
   
6. De volta ao Klaviyo, o senhor pode optar por verificar os webhooks do Stripe inserindo seu segredo de assinatura (recomendado). Isso pode ser encontrado no Stripe em Developers > Webhooks e adicionará um nível extra de segurança à sua integração.
   
7. Copie o URL do webhook dessa página. Isso será colado na sua conta do Stripe na próxima seção. 
8. Clique em Complete setup (Concluir configuração).

Configurar webhooks do Stripe

Agora vamos configurar os webhooks do Stripe, que permitirão que o senhor sincronize os dados do Stripe em tempo real.

1. Abra o Stripe em uma nova guia e navegue até a guia Developers (Desenvolvedores ).
2. Selecione Webhooks e clique em Add endpoint.
   
3. Preencha os seguintes campos:
   • URL do ponto de extremidade
     Cole o URL que você acabou de copiar do Klaviyo.
   • Versão
     Selecione a versão mais recente da API.
   • Eventos a serem enviados
     O Klaviyo requer pontos de dados de cobrança e fatura. No menu suspenso Eventos a serem enviados, selecione todos os eventos de cobrança e fatura. Opcionalmente, o senhor pode omitir todos os eventos charge.dispute. Crie endpoints para todos os eventos a seguir:
     • charge.captured
     • charge.expired
     • charge.failed
     • charge.pending
     • charge.refunded
     • charge.succeeded
     • charge.updated
     • invoice.created
     • invoice.deleted
     • invoice.finalized
     • invoice.marked_uncollectible
     • invoice.payment_action_required
     • invoice.payment_failed
     • invoice.payment_succeeded
     • invoice.sent
     • invoice.upcoming
     • invoice.updated
     • invoice.voided
4. Depois de selecionar todos os eventos de cobrança e fatura, selecione Add endpoint.
   
5. O senhor receberá uma confirmação de que seus webhooks estão ativados.
   
6. Sua integração com o Stripe agora está ativada.

Visualizar dados sincronizados do Stripe

Para verificar sua integração habilitada:

1. Clique no menu suspenso Analytics no Klaviyo e selecione Metrics.
2. Encontre a métrica Successfully Paid (Pagamentos bem-sucedidos ) do Stripe e clique no ícone Activity Feed (Feed de atividades ).
   
3. Se sua integração tiver iniciado a sincronização de dados, o senhor verá as faturas emitidas pelo Stripe serem preenchidas aqui. Quando sua integração estiver totalmente sincronizada, a integração do Stripe mostrará uma borda verde ao lado dela em sua conta do Klaviyo. O Klaviyo importa todos os seus dados do Stripe. Para verificar isso, o senhor pode comparar o número de pagamentos bem-sucedidos em um determinado dia com o que está na interface do Stripe e confirmar se eles correspondem.
4. Por exemplo, clique no título do gráfico para a métrica Successfully Paid (Pagamentos bem-sucedidos ). Por padrão, esse gráfico mostra os últimos 30 dias de dados. Passe o mouse sobre o ponto de dados de ontem ou consulte a tabela de dados abaixo do gráfico para ver quantos pagamentos o senhor fez ontem. Compare esse número com o que está armazenado no Stripe e o senhor verá que eles são exatamente iguais.
5. Se os dados não coincidirem, o problema provavelmente é que o fuso horário da sua conta Klaviyo não coincide com o fuso horário da sua conta Stripe. Para verificar sua configuração de fuso horário no Klaviyo:
   • Clique no nome de sua conta no canto inferior esquerdo.
   • Selecione e clique em Settings (Configurações) > Organization (Organização).
   • Role para baixo até Timezone.

As métricas do Stripe

O Stripe sincroniza as seguintes métricas com o Klaviyo:

• Falha no pagamento
• Fatura emitida
• Pagamento reembolsado
• Pago com sucesso

Falha no pagamento

Essa métrica é registrada toda vez que um pagamento feito por meio do Stripe é marcado como falho. Utilize essa métrica para segmentar clientes com pagamentos em atraso e informá-los de que têm um saldo em atraso. O senhor pode filtrar e direcionar eventos de Failed Payment com base nos seguintes critérios:

• AttemptCount
  O número de vezes que essa fatura tentou cobrar o usuário.
• Moeda
  A moeda da fatura que não foi paga, por exemplo, USD, GBP.
• Invoice
  A fatura à qual esse pagamento com falha está vinculado no Stripe.
• Reason
  O motivo pelo qual esse pagamento falhou no Stripe, por exemplo, Seu cartão expirou, Seu cartão foi recusado.

Fatura emitida

Essa métrica é registrada sempre que uma fatura é emitida para seus clientes por meio do Stripe. Use essa métrica para segmentar os clientes que receberam uma fatura, mas que não pagaram ou tiveram um pagamento falho. Ele também pode ser usado para acionar segmentos para notificar os clientes sobre um pagamento futuro.

Pagamento reembolsado

Essa métrica registra um evento quando o usuário reembolsa um pagamento por meio do Stripe. O senhor pode filtrar e direcionar eventos de Refunded Payment com base nos seguintes critérios:

• Valor
  O valor do pagamento que foi reembolsado.

Pago com sucesso

Essa métrica é registrada toda vez que um cliente paga com sucesso uma fatura por meio do Stripe. Esses eventos incluem dados sobre o cliente, a fatura e os produtos da fatura. Use essa métrica para enviar faturas automatizadas aos clientes depois que eles pagarem, ou em fluxos de e-mail para determinar quando um cliente esteve ativo em seu site, mas não fez pagamentos por seus produtos ou serviços. O senhor pode então enviar e-mails a esses usuários oferecendo descontos para que façam uma compra em seu site.

O senhor pode filtrar e direcionar eventos Successfully Paid com base nos seguintes critérios:

• Moeda
  A moeda da fatura paga, por exemplo, USD, GBP.
• Invoice
  A fatura à qual esse pagamento está vinculado no Stripe.

Dados do cliente

A Klaviyo identifica cada indivíduo exclusivamente por seu endereço de e-mail. Se o Stripe sincronizar os dados do cliente com um novo endereço de e-mail, a Klaviyo criará um novo perfil que consiste no endereço de e-mail do cliente e nas métricas do Stripe associadas. As datas de vencimento do cartão de crédito são armazenadas como uma propriedade personalizada no perfil de um cliente.

Usar dados do Stripe no Klaviyo

Qualquer métrica ou metadado do Stripe pode ser usado para acionar um fluxo no Klaviyo.

Faturas automatizadas

O senhor pode enviar recibos de faturas para seus clientes automaticamente depois que eles fizerem um pagamento, configurando um fluxo de faturas, acionado pela métrica Successfully Paid do Stripe.

Esse fluxo pode preencher automaticamente um e-mail que exibe detalhes dinâmicos de pagamento usando tags de modelo que fazem referência aos atributos de pagamento do Stripe.

Para obter mais informações sobre a incorporação de dados dinâmicos em um modelo de e-mail, consulte nosso artigo sobre tags de modelo e sintaxe de variáveis.

O Stripe falhou no fluxo de pagamentos

Alerte seus clientes sobre uma falha de pagamento com um fluxo automatizado, acionado pela métrica Stripe Failed Payment.

Solução de problemas

Não estou vendo todas as atividades do Stripe sincronizadas com o Klaviyo.

O motivo mais comum pelo qual um evento do Stripe não é sincronizado com o Klaviyo é porque não há um endereço de e-mail associado ao evento. Como a Klaviyo usa um endereço de e-mail para identificar uma pessoa de forma exclusiva, não podemos criar um perfil para alguém que não esteja associado a um endereço de e-mail. Da mesma forma, a Klaviyo não pode vincular um evento a um perfil se ele não estiver associado a um endereço de e-mail.

Lembre-se de que as entradas de nome e sobrenome não são necessariamente consistentes ou exclusivas, portanto, não criamos perfis com base apenas nessas informações. Isso pode levar a duplicatas e rastreamento impreciso.

Se, mesmo com os endereços de e-mail associados, o senhor ainda não estiver vendo a sincronização dos dados do Stripe com o Klaviyo, entre em contato com nossa equipe de suporte.

Resultado

O senhor já integrou o Stripe ao Klaviyo e aprendeu a usar os dados sincronizados.

Recursos adicionais

• Introdução aos fluxos
• Introdução aos segmentos
• Compreensão dos tipos de dados trocados entre a Klaviyo e os aplicativos