Conectar o Stripe ou o Mercado Pago
Guarde as chaves do seu gateway uma vez, criptografadas, para que qualquer formulário conversacional possa receber pagamentos sem que uma credencial chegue perto de um fluxo.
Você vai precisar: Acesso de proprietário da conta ou de administrador, e uma conta no Stripe ou no Mercado Pago.
Antes que um formulário conversacional possa cobrar alguém, o Tayon precisa das chaves do seu gateway. É na conexão de pagamento que elas ficam. Você as informa uma vez, elas são criptografadas e, daí em diante, os seus fluxos se referem à conexão pelo nome.
ConfiguraçãoConexões de Pagamento
A própria tela diz sem rodeios: “Conecte o Stripe ou o Mercado Pago para que seus fluxos conversacionais possam receber pagamentos. Suas chaves são criptografadas e nunca mais são exibidas depois de salvas.”
#Crie uma conexão
- Escolha Nova conexão.
- Dê um nome que você vá reconhecer no Flow Designer — Stripe BR é um nome melhor do que Stripe.
- Escolha o Gateway, Stripe ou Mercado Pago.
- Escolha o Modo, PRODUÇÃO ou TESTE.
- Cole as credenciais do painel do seu gateway.
- Salve.
O Stripe pede uma Chave secreta, uma Chave publicável e uma Chave de assinatura do webhook. O Mercado Pago pede um Token de acesso, uma Chave pública e uma Chave de assinatura do webhook. A chave do webhook é a única que você ainda não tem como ter — veja abaixo.
A Moeda padrão é opcional. Cada etapa de pagamento de um fluxo define a própria moeda de qualquer jeito.
#Suas chaves somem assim que você salva
É também por isso que uma caixa de credencial vazia quando você usa Editar significa mantenha o que está lá, e não apague. Digite em uma caixa só quando você realmente quiser substituir aquela chave.
Se uma conexão estiver com o selo Insegura — informe as credenciais novamente, as chaves dela foram guardadas antes de a criptografia existir. Abra a conexão e cole as chaves de novo.
#Cadastre o webhook
O webhook é como o Tayon descobre que um pagamento realmente deu certo, em vez de adivinhar pelo navegador do comprador. Sem ele, os pagamentos por cartão ainda se resolvem, mas os pedidos de PIX e boleto ficam em Aguardando pagamento para sempre.
- Abra a conexão e copie a URL que fica em Webhook.
- Cole essa URL no painel do seu gateway — no Stripe, Desenvolvedores → Webhooks → Adicionar endpoint; no Mercado Pago, Suas integrações → Webhooks, tópico payment.
- Assine os eventos que a tela lista.
- O seu gateway então fornece uma chave de assinatura. Volte aqui, use Editar na conexão e cole a chave em Chave de assinatura do webhook.
Gerar nova URL de webhook existe para o caso de o endereço ter vazado.
#Teste antes de vender qualquer coisa
Testar conexão pergunta ao gateway se as chaves funcionam, e diz qual é o caso:
| O que aparece | O que fazer |
|---|---|
| Conexão verificada. | Nada. O cartão mostra Verificada e quando. |
| O gateway recusou estas credenciais | Confira a chave e confira se o Modo corresponde ao modo da própria chave. Uma chave de produção em uma conexão de teste falha aqui. |
| Não conseguimos falar com o gateway | É um problema do nosso lado, não da sua chave. Tente de novo em instantes. |
| Tentativas demais | Espere um minuto. |
Uma conexão que nunca foi testada mostra Nunca verificada. Teste antes de publicar um fluxo que dependa dela.
#Os selos da lista
| Selo | Significado |
|---|---|
| Padrão | A conexão que um fluxo usa quando não indica nenhuma, para aquele gateway |
| TESTE | Não recebe dinheiro de verdade |
| Herdada | Pertence a uma conta principal e aparece aqui apenas para leitura |
| Insegura — informe as credenciais novamente | Guardada antes da criptografia; abra e informe as chaves de novo |
#Conexões padrão
Há uma conexão padrão por gateway. A primeira conexão que você cria para um gateway vira a padrão, tendo você marcado a caixa ou não, para que um fluxo configurado como Padrão da conta sempre tenha algo a que recorrer.
Você não consegue desmarcar a única conexão padrão — você a muda de lugar, definindo outra conexão como padrão. Excluir a padrão promove a conexão restante mais antiga.
#Editar, Desativar, Excluir
| Ação | O que acontece |
|---|---|
| Editar | Muda o nome, o modo, a marcação de padrão, a moeda, ou substitui uma credencial. O gateway continua fixo. |
| Desativar | Os fluxos param de conseguir usá-la, imediatamente. Os pagamentos passados continuam registrados. Ativar reverte. |
| Excluir | Remove a conexão. Os pagamentos passados continuam registrados, mas qualquer fluxo no ar que a use para de receber na hora. |
Excluir uma conexão a que pedidos se referem avisa você quantos são e pede confirmação.
#Suas chaves nunca entram em um fluxo
Uma etapa de pagamento no Flow Designer guarda uma referência a uma conexão — nunca uma chave. Isso significa que você pode duplicar um fluxo, passá-lo para um colega ou exportá-lo, e nenhuma credencial vai junto. Mude uma chave aqui e todo fluxo que usa a conexão passa a usar a nova, sem edição nenhuma.
#Próximos passos
Atualizado: