A integração com PayTR permite que você aceite pagamentos através do PayTR, um provedor de serviços de pagamento turco. Os clientes concluem seus pagamentos na página segura de pagamento do PayTR, onde podem usar cartões bancários turcos e outros métodos de pagamento locais.

Obtendo Credenciais de Integração

Antes de conectar o PayTR, assine um contrato com o PayTR e obtenha acesso à sua conta de comerciante.

No menu esquerdo, abra Bilgi (Informações) e localize a seção API Entegrasyon Bilgileri. Copie os seguintes valores:

Painel PayTR Campo Mavibot
Mağaza No Merchant ID (merchant_id)
Mağaza Anahtarı Merchant Key (merchant_key)
Mağaza Şifresi Merchant Salt (merchant_salt)

Nota: Essas credenciais estão disponíveis apenas para o Ana Kullanıcı (Usuário Principal) e o Teknik Sorumlu (Responsável Técnico). Se você não conseguir ver esta seção, peça ao proprietário da conta principal para conceder as permissões necessárias.

Você não precisa configurar uma URL de notificação de pagamento (callback) no painel do PayTR. O Mavibot envia automaticamente a URL de callback com cada solicitação de link de pagamento.

Conectando o PayTR

Abra as configurações de Adquirência no Mavibot e selecione PayTR.

Insira as seguintes credenciais:

  • Merchant ID (merchant_id) — seu Mağaza No
  • Merchant Key (merchant_key) — seu Mağaza Anahtarı
  • Merchant Salt (merchant_salt) — seu Mağaza Şifresi

Salve as configurações para concluir a integração.

Use a função de calculadora:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Parâmetros

Parâmetro Obrigatório Descrição
amount ✅ Valor do pagamento.
description Não Descrição do pagamento (produto ou serviço). Exibido na página de pagamento do PayTR.
currency Não Moeda do pagamento: TL, USD, EUR, GBP ou RUB. Padrão: TL.
customer_email Não Endereço de e-mail do cliente.
product_name Não Nome do produto exibido na página de pagamento.
expired Não Tempo de vida do link de pagamento em segundos. Se omitido, o link nunca expira.
language Não Idioma da página de pagamento: tr (turco) ou en (inglês). Padrão: tr.

A função retorna uma URL de pagamento.

Notas

  • O código de moeda TRY é automaticamente convertido para TL.
  • Se uma moeda não suportada for especificada, TL é usada automaticamente.
  • O nome do produto deve conter 4–200 caracteres.
    • Nomes com menos de 4 caracteres são preenchidos com pontos (.).
    • Nomes com mais de 200 caracteres são automaticamente truncados.

Exemplo

Passo 1

Crie uma mensagem pedindo ao cliente para inserir seu endereço de e-mail.

Passo 2

Crie o próximo bloco abaixo da mensagem e abra as configurações de seta.

Configure a Conexão da seguinte forma:

  • Tipo de correspondência: Expressão regular
  • Ative a opção Usuário insere dados.
  • Insira o nome da variável: customer_email

Salve as configurações da Conexão.

Passo 3

Insira os parâmetros da função na calculadora.

Criando um Botão de Pagamento

Para enviar um botão de pagamento no Mavibot:

  1. Crie o bloco com um botão.

  1. Selecione o tipo Cobrança.
  2. Escolha PayTR como provedor de pagamento.
  3. Especifique:
    • Nome do produto
    • Valor do pagamento
    • Moeda
  4. Opcionalmente, forneça a variável contendo o endereço de e-mail do cliente.

Callbacks de Pagamento

Após o cliente concluir o pagamento, o Mavibot recebe um callback e o publica na conversa.

Pagamento Bem-sucedido

SDJ91MTKTT_success 100

Onde:

  • SDJ91MTKTT são os primeiros 10 caracteres da sua Merchant Key (merchant_key).
  • 100 é o valor do pagamento.

Para reagir a pagamentos bem-sucedidos ou com falha, copie o valor do callback e crie um bloco Iniciar (ou bloco de Gatilho).

Insira o texto do callback no gatilho.

Em seguida, crie uma mensagem informando o cliente se o pagamento foi bem-sucedido ou falhou.

A partir deste bloco, você pode continuar o fluxo do seu chatbot conforme necessário.

Nota: A configuração de gatilho mostrada neste exemplo responderá a cada pagamento bem-sucedido, pois usa apenas o prefixo do callback sem o valor do pagamento.
Se você quiser reagir apenas à compra de um produto específico ou valor de pagamento, insira o texto completo do callback, incluindo o valor do pagamento, e altere o Tipo de correspondência para Correspondência exata.

Pagamento com Falha

SDJ91MTKTT_fail 100

Nota: Os links de pagamento do PayTR são de uso único. Após um pagamento bem-sucedido, o link é automaticamente desativado. Gere um novo link de pagamento para cada novo pagamento.

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

Variável Descrição
paytr_callback_data Informações de pagamento recebidas do PayTR.
paytr_payment_completed "True" se o pagamento foi processado com sucesso.
paytr_merchant_oid Identificador de transação do PayTR (merchant_oid).