Um botão com a função Pagamento simplifica o trabalho com sistemas de pagamento conectados, fornecendo um link de pagamento.
Observe que, em muitos mensageiros, os links só podem ser colocados em botões inline dentro do texto. Não se esqueça de selecionar o tipo de botão apropriado nas configurações do bloco após criar o botão.
O botão com a função Pagamento está disponível para os seguintes sistemas de pagamento:
- Stripe
Dentro de um único bloco, você pode criar botões "Pagamento" para diferentes sistemas de pagamento com diferentes valores de pagamento.
Se nenhum sistema de pagamento estiver conectado ao projeto, este tipo de botão não estará disponível.
Campos principais do botão de Pagamento:
- Campo de texto: Este texto aparecerá no botão com o link de pagamento na mensagem.
- Função: Selecione o tipo de botão Pagamento.
- Campo de função: Para criar um botão que fornece um link de pagamento, escolha a função Pagamento.
- Campo do sistema de pagamento: A lista mostra os sistemas de pagamento conectados ao projeto.
Dependendo do sistema de pagamento escolhido, os campos obrigatórios para gerar o link e criar o recibo variam.
Você pode visualizar as configurações do botão da função Pagamento para diferentes sistemas de pagamento aqui:
Os campos obrigatórios para gerar o link de pagamento são Valor e Nome do produto/Descrição do produto.
- Campo de valor: Insira o valor do pagamento aqui.
- Campo de nome do produto: Insira o nome do produto que será exibido na página de pagamento.
Aspas duplas não podem ser usadas no nome do produto.
Você pode substituí-las por apóstrofos ou aspas simples.
Dependendo do sistema de pagamento escolhido, menus suspensos rotulados como "Dados do recibo" e/ou "Informações adicionais" aparecerão nas configurações do botão. Clicar neles revelará campos adicionais:
Variáveis ao usar o botão da função Pagamento
Assim que o usuário receber o bloco com o botão "Pagamento", as seguintes variáveis de cliente são criadas automaticamente:
-
Variável de cliente do sistema
__payments– esta variável armazena o valor do pagamento e o identificador do link de pagamento gerado. É usada para identificar a resposta do webhook do sistema de pagamento.
A variável de cliente do sistema __payments não deve ser excluída ou modificada!
A variável de cliente error_payment_button é criada se ocorrer um erro ao gerar o botão de pagamento.
Seu valor conterá a mensagem de erro ou a resposta de erro retornada pelo sistema de pagamento.
Os valores das variáveis se tornam ativos (atualizados) quando o usuário passa para o próximo bloco.
Como lidar com o resultado
Pagamento bem-sucedido
Após um pagamento bem-sucedido, o bot receberá um callback composto pelos primeiros 10 caracteres da chave secreta do sistema de pagamento, a palavra _success e o valor do pagamento separados por um espaço. Por exemplo: ovg58keefc_success 44, onde:
-
ovg58keefc: os primeiros 10 caracteres da chave secreta do sistema de pagamento -
_success: indica o resultado da solicitação (pagamento bem-sucedido) -
44: o valor do pagamento
Os callbacks (notificações) do sistema de pagamento não são visíveis para o usuário. Eles são exibidos apenas na guia Clientes e são visíveis para o operador.
Exemplo de uso: Passo 1. No bloco com o botão Pagamento, adicione botões com a função Pagamento. Passo 2. No campo Condição de conexão deste bloco para o bloco Pagamento bem-sucedido, especifique o callback. Isso funciona da mesma forma se você especificar o callback de pagamento bem-sucedido no campo Condição do bloco Verificação de condição primária.
Nota! Seleção do tipo de correspondência — Correspondência exata ou Correspondência de palavra-chave.
Dica útil
Para enviar uma notificação sobre um pagamento bem-sucedido ao cliente sem interromper seu progresso no funil principal, crie "Blocos não-estados com condições."
Pagamento com erro
Se ocorrer um erro de pagamento, o bot receberá um callback composto pelos primeiros 10 caracteres da chave secreta do sistema de pagamento, a palavra _fail e o valor do pagamento separados por um espaço. Por exemplo: ovg58keefc_fail 44, onde:
-
ovg58keefc: os primeiros 10 caracteres da chave secreta do sistema de pagamento -
_fail: o resultado do processamento da solicitação — pagamento falhou ou encontrou um erro -
44: o valor do pagamento
Isso depende do sistema de pagamento. Nem todos os sistemas de pagamento enviam um callback para erros de pagamento.
Se o valor especificado nas configurações do botão for diferente do valor realmente pago pelo cliente, o bot receberá um callback composto pelos primeiros 10 caracteres da chave secreta do sistema de pagamento, a frase _different_amounts e um ID de pagamento único separados por um espaço. Por exemplo: ovg58keefc_different_amounts 123456, onde:
-
ovg58keefc: os primeiros 10 caracteres da chave secreta do sistema de pagamento -
_different_amounts: o resultado do processamento da solicitação (o valor do pagamento difere do valor no link) -
123456: ID de pagamento único