Guia de introdução ao Stripe

O que você vai aprender

Aprenda a integrar o Stripe com a Klaviyo para personalizar e segmentar e-mails com base em dados de fatura e pagamento dos seus clientes.

Você vai configurar a integração do Stripe em 2 etapas. Primeiro, você vai conectar o Stripe ativando a integração no Klaviyo. Depois, você configura webhooks no Stripe, o que vai permitir uma sincronização em tempo real de dados específicos do Stripe no Klaviyo.

Veja 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

Habilite a integração do Stripe na Klaviyo

1. Na Klaviyo, selecione a aba Integrações.
2. Selecione Explorar aplicativos, procure por Stripe e clique no cartão.
3. Em seguida, clique em Instalar.
4. Clique em Conectar-se à Stripe. Isso vai levar você ao site da Stripe — faça login se necessário.
5. Selecione a conta do Stripe que você quer conectar à Klaviyo e clique em Conectar.
   
6. De volta à Klaviyo, você pode optar por verificar webhooks do Stripe inserindo seu segredo de assinatura (recomendado). Isso pode ser encontrado no Stripe em Desenvolvedores > Webhooks e adicionará um nível extra de segurança à sua integração.
   
7. Copie a URL do webhook desta página. Ela será colada na sua conta do Stripe na próxima seção.
8. Clique em Concluir configuração.

Configurar webhooks do Stripe

Agora vamos configurar seus webhooks do Stripe, que permitirão que você sincronize seus dados do Stripe em tempo real.

1. Abra o Stripe em uma nova guia e navegue até a guia Desenvolvedores.
2. Selecione webhook e clique em Adicionar ponto de extremidade.
   
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 para enviar A Klaviyo exige pontos de dados de cobranças e faturas. No menu suspenso Eventos para enviar, selecione todos os eventos de charge e invoice. Opcionalmente, você pode omitir todos os eventos de charge.dispute. Crie pontos de extremidade para todos os seguintes eventos:
     • charge.captured
     • charge.expired
     • charge.failed
     • charge.pending
     • charge.refunded
     • charge.succeeded
     • cobranca.atualizada
     • invoice.created
     • fatura.excluída
     • 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 Adicionar ponto de extremidade.
   
5. Você vai receber a confirmação de que seus webhooks estão ativados.
   
6. Sua integração com o Stripe agora está ativada.

Ver dados sincronizados da Stripe

Para verificar sua integração habilitada:

1. Clique no menu suspenso Análises no Klaviyo e selecione Métricas.
2. Encontre a métrica Successfully Paid do Stripe e clique no ícone Feed de atividades.
   
3. Se a sua integração tiver começado a sincronizar dados, você verá as faturas emitidas pelo Stripe aparecerem aqui. Quando a sua integração estiver totalmente sincronizada, a integração do Stripe exibirá uma borda verde ao lado dela na sua conta da Klaviyo. A Klaviyo importa todos os seus dados do Stripe. Para verificar isso, você pode comparar o número de pagamentos bem-sucedidos em um dia específico com o que aparece na interface do Stripe e confirmar que eles correspondem.
4. Por exemplo, clique no título Gráfico para a métrica Successfully Paid. Este gráfico mostra os dados dos últimos 30 dias por padrão. Passe o mouse sobre o ponto de dados de ontem ou consulte a tabela de dados abaixo do gráfico para ver quantos pagamentos você teve ontem. Compare esse número com o que está armazenado no Stripe e você verá que eles correspondem exatamente.
5. Se os dados não baterem, o problema provavelmente é que o fuso horário da sua conta da Klaviyo não corresponde ao fuso horário da sua conta da Stripe. Para conferir a configuração de fuso horário na Klaviyo:

• Clique no nome da sua conta no canto inferior esquerdo.
• Selecione e clique em Configurações > Organização.
• Role para baixo até Fuso horário.

As métricas do Stripe

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

• Falha no Pagamento
• Fatura Emitida
• Pagamento Reembolsado
• Pagamento Confirmado

Falha no Pagamento

Essa métrica é registrada sempre que um pagamento feito pelo Stripe é marcado como falho. Use essa métrica para segmentar clientes com pagamentos falhos e avisar que eles têm um saldo em atraso. Você pode filtrar e segmentar eventos de Pagamento Falho com base nos seguintes critérios:

• AttemptCount O número de vezes que esta fatura tentou cobrar do usuário.
• Moeda A moeda da fatura não pôde ser paga, por exemplo, USD, GBP.
• Fatura A fatura à qual esse pagamento com falha está vinculada no Stripe.
• Motivo 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 toda vez que uma fatura é emitida para seus clientes pelo Stripe. Use essa métrica para segmentar clientes para os quais uma fatura foi emitida, mas que não pagaram ou cujo pagamento falhou. Ela também pode ser usada para acionar segmentos que notificam os clientes sobre um pagamento futuro.

Pagamento Reembolsado

Essa métrica registra um evento quando você reembolsa um pagamento pelo Stripe. Você pode filtrar e segmentar eventos de Pagamento Reembolsado com base nos seguintes critérios:

• Valor O valor do pagamento que foi reembolsado.

Pagamento Confirmado

Esta métrica é registrada toda vez que um cliente paga uma fatura com sucesso pelo Stripe. Esses eventos incluem dados sobre seu cliente, a fatura dele e os produtos na fatura. Use esta métrica para enviar faturas automatizadas aos clientes depois que eles pagarem ou, em fluxos de e-mail, para determinar quando um cliente está com atividade no seu site, mas não fez pagamentos pelos seus produtos ou serviços. Em seguida, você pode enviar a esses usuários e-mails oferecendo descontos para fazer uma compra no seu site.

Você pode filtrar e segmentar eventos de Pagamento realizado com base nos seguintes critérios:

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

dados do cliente

O Klaviyo identifica exclusivamente cada pessoa pelo endereço de e-mail. Se o Stripe sincronizar dados do cliente com um novo endereço de e-mail, o Klaviyo criará um novo perfil composto pelo endereço de e-mail do cliente e pelas métricas do Stripe associadas. As datas de validade do cartão de crédito são armazenadas como uma propriedade personalizada no perfil do cliente.

Um dos eventos do Stripe listados acima deve ocorrer para que um perfil seja criado na Klaviyo.

Use dados da Stripe na Klaviyo

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

Faturas automatizadas

Você pode enviar recibos de fatura para seus clientes automaticamente depois que eles fizerem um pagamento ao configurar um fluxo de faturas, acionado pela métrica Successfully Paid da Stripe.

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

Para mais informações sobre como incorporar dados dinâmicos em um modelo de e-mail, consulte nosso artigo sobre tag de modelo e sintaxe de variáveis.

Fluxo de pagamentos com falha do Stripe

Avise seus clientes sobre um pagamento com falha com um fluxo automatizado, acionado pela métrica Pagamento com falha do Stripe.

Solução de problemas

Não estou vendo toda a atividade no Stripe sincronizar com o Klaviyo.

O motivo mais comum para um evento do Stripe não sincronizar com o Klaviyo é porque não há um endereço de e-mail associado ao evento. Como o Klaviyo usa um endereço de e-mail para identificar exclusivamente uma pessoa, não podemos criar um perfil para alguém que não esteja associado a um endereço de e-mail. Da mesma forma, o 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 únicas, portanto não criamos perfis com base apenas nessas informações. Fazer isso pode gerar duplicatas e um rastreamento impreciso.

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

Resultado

Agora você integrou o Stripe à Klaviyo e aprendeu como usar seus dados sincronizados.