Conectando o Telr

Para usar o sistema de pagamento Telr no MaviBot, você precisa obter as credenciais da sua loja na sua conta Telr e inseri-las nas configurações do sistema de pagamento.

Obtendo as Credenciais da Loja

Assine um contrato com a Telr e obtenha acesso à sua conta de comerciante.

Em Lojas → Detalhes da loja, copie os seguintes valores:

Campo Telr Campo MaviBot
Store ID Store ID
Authentication key Authentication Key

Configurando Notificações de Pagamento

Abra Página de Pagamento (ou Segurança) → Aviso de transação e especifique a seguinte URL de notificação:

https://chatter.mavibot.ai/telr_callback/result

Selecione os tipos de transação para os quais deseja receber notificações.

Na mesma seção, copie a Chave secreta. Esta chave é usada para verificar as assinaturas das notificações.

Importante! A configuração do Aviso de transação é obrigatória. Sem ela, o MaviBot não receberá notificações de pagamento e nenhum callback será enviado ao bot.

Conectando o Telr no MaviBot

Abra Sistemas de Pagamento nas configurações do seu projeto, selecione Telr e preencha os seguintes campos:

Campo Descrição
Store ID Identificador numérico da sua loja Telr.
Authentication Key Usada para gerar links de pagamento.
Secret Key Usada para verificar as assinaturas das notificações de pagamento. Sem ela, as notificações de pagamento serão rejeitadas.
Test Mode Ativa pagamentos de teste usando cartões de teste Telr sem cobrar fundos reais. Desative esta opção para aceitar pagamentos reais.

Depois que todos os campos forem preenchidos, a integração estará pronta para uso.

Gerando um Link de Pagamento

Use a seguinte função da Calculadora:

get_telr_payment_url(amount, description, currency, product_name)

Parâmetros

Parâmetro Descrição
amount Valor do pagamento. Obrigatório.
description Descrição do pagamento. Opcional. Comprimento máximo: 63 caracteres.
currency Código de moeda de três letras (AED, SAR, USD, EUR, GBP e outras moedas disponíveis para sua conta Telr). Opcional. Padrão: AED.
product_name Nome do produto. Opcional.

A função retorna uma URL de pagamento.

Importante! Os links de pagamento permanecem válidos por um tempo limitado. Envie o link ao cliente imediatamente após gerá-lo.

Exemplo

Para enviar um botão de pagamento:

  1. Crie um botão com a função Pay.
  2. Selecione Telr como sistema de pagamento.
  3. Especifique:
    • Nome do produto
    • Valor do pagamento
    • Moeda

Callbacks de Pagamento

Após o cliente concluir o pagamento, o MaviBot recebe automaticamente um callback.

Pagamento Bem-sucedido

Exemplo:

SDJ91MTKTT_success 100

Onde:

  • SDJ91MTKTT — os primeiros 10 caracteres da sua Authentication Key.
  • 100 — o valor do pagamento.

Pagamento Falhou ou Cancelado

Exemplo:

SDJ91MTKTT_fail 100

Pagamento em Revisão Bancária

Se um pagamento for autorizado, mas colocado em espera pelo banco para verificação adicional, nenhum callback é enviado até que a revisão seja concluída.

Assim que o banco aprovar ou recusar a transação, a Telr envia uma notificação e o callback é entregue ao MaviBot automaticamente.

Variáveis do Cliente Após um Pagamento Bem-sucedido

Variável Descrição
telr_callback_data Informações de pagamento recebidas do sistema de pagamento Telr.
telr_payment_completed "True" se o pagamento foi processado com sucesso.
telr_tran_ref Referência da transação Telr (tran_ref).