Para usar o PagBank como provedor de pagamento no Mavibot, você precisa obter um token de acesso da sua conta PagBank e inseri-lo nas configurações de pagamento.

Obtendo um Token

Ambiente de produção: faça login na sua conta PagBank a partir de um computador, vá em Vendas → Integrações e clique em Gerar token.

Ambiente de teste (sandbox): faça login no Portal do Desenvolvedor PagBank, abra a aba Tokens e copie seu token de sandbox.

O token é exibido apenas uma vez. Armazene-o em um local seguro: se você o perder, precisará gerar um novo e o token antigo deixará de funcionar.

Você não precisa configurar uma URL de notificação de pagamento na sua conta PagBank — o Mavibot a fornece automaticamente ao criar cada pagamento.

Configuração

Nas configurações do sistema de pagamento, selecione PagBank e insira:

  • Token — o token de acesso à API da sua conta PagBank.
  • Modo de teste — ative esta opção se você inseriu um token de sandbox. No modo de teste, as requisições são enviadas para sandbox.api.pagseguro.com e nenhum dinheiro real é cobrado.

A configuração está concluída.

Função da calculadora:

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

Parâmetros

Parâmetro Descrição
amount Valor do pagamento. Obrigatório. Mínimo: 1 BRL; máximo: 9.999.999 BRL. Insira o valor como 100.55, não 10055.
description Descrição do pagamento. Opcional, até 255 caracteres. O cliente a verá na página de pagamento.
product_name Nome do produto, até 100 caracteres. Opcional; description é usado por padrão.
customer_email Endereço de e-mail do cliente. Opcional; pré-preenchido na página de pagamento.
customer_phone Número de telefone do cliente. Opcional; pré-preenchido na página de pagamento. O PagBank aceita apenas números de celular brasileiros: código do país 55, um código de área de dois dígitos e um número de nove dígitos começando com 9 (por exemplo, +55 11 99999-8888).
full_name Nome e sobrenome do cliente. Opcional; pré-preenchido na página de pagamento.
identity_number CPF (11 dígitos) ou CNPJ (14 dígitos) do cliente. Opcional; pré-preenchido na página de pagamento.

A função retorna uma URL de pagamento.

O PagBank aceita os dados do cliente apenas como um conjunto completo: nome, e-mail, número de telefone e CPF/CNPJ devem ser todos fornecidos. Se algum desses quatro campos estiver faltando, ou se o número de telefone não for um número de celular brasileiro válido, o Mavibot não enviará nenhum dos dados do cliente para o PagBank. O cliente simplesmente os preencherá na página de pagamento. Isso não afeta o pagamento em si.

Para enviar um botão com um link de pagamento, selecione o tipo de botão de pagamento e escolha PagBank como o sistema de pagamento. Insira o nome do produto e o valor do pagamento. Se necessário, especifique variáveis contendo o nome, endereço de e-mail e número de telefone do cliente.

Callbacks Após o Pagamento

Após o cliente seguir o link e concluir o pagamento, um callback de pagamento bem-sucedido será enviado para o diálogo:

A1B2C3D4E5_success 100.55

Aqui, A1B2C3D4E5 são os primeiros 10 caracteres do seu token e 100.55 é o valor do pagamento.

Se o pagamento falhar, o seguinte callback será enviado:

A1B2C3D4E5_fail 100.55

Um callback de falha é enviado apenas quando o link de pagamento não pode mais ser usado: o banco recusou ou cancelou permanentemente o pagamento, ou o link de pagamento expirou. Nenhum callback é enviado enquanto o pagamento está em análise, aguardando pagamento de boleto ou autorizado, mas ainda em espera no cartão, pois o link de pagamento permanece ativo. Um link de pagamento expirado não tem pagamento associado, portanto, o callback não incluirá um valor.

Para lidar com um pagamento bem-sucedido ou com falha, siga estas etapas:

  1. Crie um bloco com um gatilho (um bloco Trigger cinza ou um bloco Start verde — use o bloco verde se quiser continuar construindo o funil após o pagamento).
  2. No campo Trigger, insira o callback sem o valor do pagamento:
A1B2C3D4E5_success

Use esta opção se quiser que o bloco reaja a cada pagamento bem-sucedido.

Defina o tipo de correspondência como Keyword Match.

Alternativamente, insira o callback completo:

A1B2C3D4E5_success 100.55

Use esta opção se quiser que o bloco reaja apenas a um pagamento de um valor específico.

Defina o tipo de correspondência como Exact Match.

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

Variável Valor
pagbank_callback_data Informações de pagamento recebidas do sistema de pagamento
pagbank_payment_completed "True" — o pagamento foi processado com sucesso
pagbank_order_id ID do pedido no PagBank (ORDE_…)
pagbank_charge_id ID da cobrança no PagBank (CHAR_…)
pagbank_payment_method Método de pagamento: CREDIT_CARD, DEBIT_CARD, PIX ou BOLETO