Como configurar o Stripe como integração de pagamentos no Blip – Take Blip | Help Center

Esta funcionalidade está em beta. Quer ter acesso antecipado? Inscreva-se para testá-la antes do lançamento oficial!

Índice:

Com a integração Stripe é possível melhorar cada vez mais a experiência dos contatos que interagem com o Contato Inteligente da sua marca, permitindo que eles realizem pagamentos com cartão de crédito e boleto bancário.

O que é?

A integração Stripe permite conectar o Contato Inteligente ao provedor de pagamentos Stripe, facilitando a geração de links de pagamento (cartão de crédito e boleto bancário) ou pagamento Card On File diretamente no fluxo de conversa de um chatbot.

Como funciona?

Ao ativar a integração no contato inteligente, torna-se possível enviar comandos diretamente do fluxo do chatbot para gerar links de pagamento ou realizar pagamentos utilizando cartões salvos previamente (Card On File).

Sempre que a situação de um pagamento mudar, o contato poderá ser notificado automaticamente com uma mensagem padrão. Também poderão ser configuradas mensagens customizadas nas configurações avançadas do contato inteligente.

Após a integração do Stripe com o chatbot estar ativa, é possível criar interações de pagamento no Builder do Blip.

Orientações de uso

A integração com Stripe não armazena dados sensíveis como cartões de crédito ou dados bancários.
Envio de notificações de pagamentos para contatos.
Para enviar notificações a contatos do WhatsApp, a aplicação utiliza Message Templates (Modelos de mensagens (message templates) do WhatsApp) que são criados automaticamente na WABA (WhatsApp Business Account) durante a ativação da integração do Stripe, seguindo as regras do WhatsApp.
Caso o contato esteja em atendimento humano, a notificação não será entregue, independente do canal.

Pré-requisitos

Possuir um chatbot (Como criar um bot com o Builder do Blip)
Possuir conta no Stripe (https://stripe.com)
Caso não possua uma conta no Stripe, é possível criar uma conta de teste. (Documentação: Conta | Documentação da Stripe)
Possuir a permissão de visualizar informações de conexões e a permissão de ver e editar integrações para visualizar o menu de pagamentos. (Documentação: Gerenciando permissões de acesso)

Instalação e configuração

1.Acesse o menu de pagamentos do portal.

2.Clique em “Integrar” no card do Stripe.

3.Acesse a aba de configurações.

4.Recupere sua chave secreta na sua conta do Stripe

5.Preencha o campo com sua chave recuperada do passo anterior.

6.Selecione os campos de mensagem automática em conformidade com o desejado.

7.Pronto, sua integração está pronta para ser utilizada.

Resolução de Problemas na Instalação e Configuração

Durante o processo de instalação e configuração da integração com o Stripe, podem ocorrer alguns erros. Abaixo são descritas algumas mensagens de erro retornadas e as respectivas soluções indicadas:

Erro de chave do Stripe inválida

Ocorre caso a chave (key secret) informada pelo cliente esteja incorreta.

Solução: Verificar a chave correta no Stripe.

Para identificar a chave corretamente, consulte a seção Instalação e configuração

Erro de criação de Message Templates

Ocorre caso a Waba tenha atingido o limite de Message Templates.

Solução: Apagar Message Templates ou solicitar aumento do limite com o suporte.

Erro genérico

Pode ocorrer caso o cliente edite/apague as configurações avançadas manualmente ou altere o Webhook no Stripe manualmente.

Solução: Apagar o Webhook no Stripe e as chaves nas configurações avançadas e refazer a integração

Identificação das chaves nas configurações avançadas(variáveis Configuration e EventNotificationConfiguration) :

Para identificar o webhook, acessar a conta do stripe: Desenvolvedores => Webhooks

A URL do webhook tem o seguinte padrão: {domínio_blip}/webhook/{id_bot}

Jornada de pagamento

Pagamento por página web via link envolve as seguintes etapas:

1.Envio do comando no fluxo do chatbot (Builder)

O retorno desse comando traz a URL de pagamento, que deve ser enviada ao contato.

2.Contato conclui o pagamento com sucesso na página web.

Ao confirmar o pagamento, o ID do cliente do Stripe é adicionado aos Extras do contato.

Em caso de falha no pagamento.

Mais informações em Tratamento de erros.

Pagamento automático (Card on File)

Funcionalidades

1.Pagamento por página web.

É possível gerar um link de pagamento apenas enviando um comando para a aplicação do Stripe.

Criar uma sessão | Blip Docs | API Reference

A URL retornada deve ser enviada ao contato que prosseguirá com o pagamento em uma página web.

Nesta página ele informará seus dados pessoais, endereço e dados do pagamento, como boleto bancário ou dados do cartão.

Pagamento automático (Card On File)

Ao realizar o primeiro pagamento, ainda na página web o contato pode optar por salvar os dados do cartão para agilizar pagamentos futuros.

Somente é possível utilizar esta funcionalidade caso o contato já tenha realizado um pagamento utilizando a integração com Stripe, optando por salvar os dados do cartão, e possua o ID do cliente do Stripe (stripe CustomerID) nos Extras.

Para realizar um pagamento automático Card On File, basta enviar um comando para a aplicação do Stripe informando o ID do cliente do Stripe (stripe CustomerID) e o ID do cartão (paymentMethod) que o contato deseja utilizar. Caso o ID do cartão não seja informado, será utilizado o cartão padrão do contato.

Criar intenção de pagamento | Blip Docs | API Reference

Para obter os cartões cadastrados para um contato, basta utilizar a funcionalidade de Consulta dos cartões salvos pelo contato.

Assim, o pagamento será confirmado automaticamente sem a necessidade do contato acessar uma URL.

Consulta dos cartões salvos pelo contato

É possível enviar um comando através do Builder para obter a lista de cartões cadastrados para o ID do cliente do Stripe (stripeCustomerID).

Estes cartões são utilizados no Pagamento Card On File

Recuperar métodos de pagamento | Blip Docs | API Reference

Consulta do histórico de pagamentos realizados pelo contato

Para consultar o histórico de sessões ou pagamentos de um contato, basta enviar um comando informando o ID do contato.

Cada sessão ou pagamento pode estar relacionado a um ou mais eventos. Para obter os eventos relacionados a uma sessão ou a um pagamento, basta enviar um comando informando o ID da sessão ou do pagamento.

Notificação de atualização do pagamento

A plataforma Stripe gera um alerta sempre que a situação de um pagamento é atualizada, seja em caso de sucesso ou falha.

Documentação de eventos do Stripe: https://stripe.com/docs/api/events/types

Dessa forma, o Blip envia uma notificação ao contato de acordo com os eventos abaixo. Caso o contato esteja em atendimento humano, a notificação não será entregue, independente do canal.

No caso do Whatsapp, é enviada uma mensagem ativa (Ver Política de violação de mensagens ativas do Blip – Blip Help Center). Para os outros canais, é enviada uma mensagem comum.

Ver Tratamento de erros para entender como verificar se a mensagem foi enviada.

Status de Pagamento	Mensagem
Pagamento cancelado	Pagamento cancelado com sucesso.
Falha no pagamento	Atenção! Erro com a forma de pagamento.
Pagamento efetuado	Pagamento realizado com sucesso!
Link de pagamento expirado	O link de pagamento expirou! Refaça seu pedido para gerar um novo link.

Customização das mensagens de status de pagamento

É possível customizar as mensagens de status de pagamento alterando a chave EventNotificationConfiguration nas Configurações Avançadas do Bot. Para isto altere a variável message referente ao eventName desejado de acordo com a tabela abaixo:

Evento (eventName)	Status de Pagamento
payment_intent.canceled	Pagamento Cancelado
payment_intent.payment_failed	Falha no Pagamento
payment_intent.succeeded	Pagamento Efetuado
checkout.session.async_payment_failed	Erro com a forma de pagamento (Boleto)
checkout.session.async_payment_succeeded	Pagamento Efetuado (Boleto)
checkout.session.expired	Link do Pagamento Expirado

Abaixo a localização das chaves eventName e message nas Configurações Avançadas:

Para customização das mensagens de status de pagamento através dos modelos de mensagens do whatsapp, utilize a tabela abaixo como referência para filtrar os modelos de mensagem de acordo com o status de pagamento que deseja customizar.

O nome do modelo de mensagem segue o padrão:

{BotId}_{NomeDoModelo}_{DDMMHH}

sendo

BotId: O identificador do bot

NomeDoModelo: Nome do modelo de mensagem de acordo com a tabela abaixo

DDMMHH: Dia, mês e hora da criação do modelo de mensagem

Nome do modelo de mensagem	Status de Pagamento
stripe_payment_intent_canceled	Pagamento Cancelado
stripe_payment_intent_payment_failed	Falha no Pagamento
stripe_payment_intent_succeeded	Pagamento Efetuado
stripe_checkout_session_async_payment_failed	Erro com a forma de pagamento (Boleto)
stripe_checkout_session_async_payment_succeeded	Pagamento Efetuado (Boleto)
stripe_checkout_session_expired	Link do Pagamento Expirado

Para informações mais detalhadas sobre a manutenção de Modelos de Mensagens do Whatsapp consulte a documentação

Tratamento de erros

Caso o contato esteja em atendimento humano, a notificação não será enviada. Pode-se verificar se a mensagem foi enviada ou não através deste comando: Blip Docs | API Reference
Se ocorrerem erros no pagamento, como dados do cartão inválidos ou pagamento não aprovado, o último erro reportado pelo Stripe será armazenado nos Extras do contato.

Serão salvos os campos abaixo:

Campo	Conteúdo	Exemplo
stripeLatestErrorCode	Código de erro do Stripe	card_declined
stripeLatestErrorMessage	Descrição do erro do Stripe	Your card was declined.
stripeLatestErrorMessage	Link da documentação do Stripe com a explicação do erro e possíveis causas	https://stripe.com/docs/error-codes/card-declined
stripeLatestErrorDate	Data e hora do erro do Stripe (dd/MM/yyyy HH:mm:ss)	01/01/2022 08:00:00

Veja a documentação de como configurar os comandos de pagamentos no Builder.

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃

Artigos relacionados