Para usar PagBank como proveedor de pagos en Mavibot, necesitas obtener un token de acceso desde tu cuenta de PagBank e ingresarlo en la configuración de pagos.

Obtención de un Token

Entorno de producción: inicia sesión en tu cuenta de PagBank desde una computadora, ve a Vendas → Integrações (Ventas → Integraciones) y haz clic en Gerar token (Generar token).

Entorno de prueba (sandbox): inicia sesión en el Portal para Desarrolladores de PagBank, abre la pestaña Tokens y copia tu token de sandbox.

El token se muestra solo una vez. Guárdalo en un lugar seguro: si lo pierdes, deberás generar uno nuevo y el token anterior dejará de funcionar.

No es necesario configurar una URL de notificación de pago en tu cuenta de PagBank — Mavibot la proporciona automáticamente al crear cada pago.

Configuración

En la configuración del sistema de pagos, selecciona PagBank e ingresa:

  • Token — el token de acceso a la API de tu cuenta de PagBank.
  • Modo de prueba — actívalo si ingresaste un token de sandbox. En modo de prueba, las solicitudes se envían a sandbox.api.pagseguro.com y no se cobra dinero real.

La configuración está completa.

Creación de un Enlace de Pago

Función de la calculadora:

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

Parámetros

Parámetro Descripción
amount Monto del pago. Obligatorio. Mínimo: 1 BRL; máximo: 9,999,999 BRL. Ingresa el monto como 100.55, no 10055.
description Descripción del pago. Opcional, hasta 255 caracteres. El cliente la verá en la página de pago.
product_name Nombre del producto, hasta 100 caracteres. Opcional; por defecto se usa description.
customer_email Correo electrónico del cliente. Opcional; se rellena previamente en la página de pago.
customer_phone Número de teléfono del cliente. Opcional; se rellena previamente en la página de pago. PagBank solo acepta números de teléfono móvil brasileños: código de país 55, un código de área de dos dígitos y un número de nueve dígitos que comience con 9 (por ejemplo, +55 11 99999-8888).
full_name Nombre y apellido del cliente. Opcional; se rellena previamente en la página de pago.
identity_number CPF del cliente (11 dígitos) o CNPJ (14 dígitos). Opcional; se rellena previamente en la página de pago.

La función devuelve una URL de pago.

PagBank acepta los datos del cliente solo como un conjunto completo: nombre, correo electrónico, número de teléfono y CPF/CNPJ deben proporcionarse todos. Si falta alguno de estos cuatro campos, o el número de teléfono no es un número móvil brasileño válido, Mavibot no enviará ninguno de los datos del cliente a PagBank. El cliente simplemente los completará en la página de pago. Esto no afecta el pago en sí.

Enlace de Pago en un Botón

Para enviar un botón con un enlace de pago, selecciona el tipo de botón de pago y elige PagBank como sistema de pago. Ingresa el nombre del producto y el monto del pago. Si es necesario, especifica las variables que contengan el nombre, correo electrónico y número de teléfono del cliente.

Callbacks Después del Pago

Después de que el cliente siga el enlace y complete el pago, se enviará un callback de pago exitoso al diálogo:

A1B2C3D4E5_success 100.55

Aquí, A1B2C3D4E5 son los primeros 10 caracteres de tu token, y 100.55 es el monto del pago.

Si el pago falla, se enviará el siguiente callback:

A1B2C3D4E5_fail 100.55

Un callback de fallo se envía solo cuando el enlace de pago ya no se puede usar: el banco ha rechazado o cancelado permanentemente el pago, o el enlace de pago ha expirado. No se envía ningún callback mientras el pago está en revisión, en espera de pago por boleto, o autorizado pero aún retenido en la tarjeta, ya que el enlace de pago sigue activo. Un enlace de pago expirado no tiene un pago asociado, por lo que el callback no incluirá un monto.

Para manejar un pago exitoso o fallido, sigue estos pasos:

  1. Crea un bloque con un disparador (un bloque Trigger gris o un bloque Start verde — usa el bloque verde si deseas continuar construyendo el embudo después del pago).
  2. En el campo Trigger, ingresa el callback sin el monto del pago:
A1B2C3D4E5_success

Usa esta opción si deseas que el bloque reaccione a cada pago exitoso.

Establece el tipo de coincidencia en Keyword Match.

Alternativamente, ingresa el callback completo:

A1B2C3D4E5_success 100.55

Usa esta opción si deseas que el bloque reaccione solo a un pago por un monto específico.

Establece el tipo de coincidencia en Exact Match.

Variables del Cliente Después de un Pago Exitoso

Variable Valor
pagbank_callback_data Información del pago recibida del sistema de pagos
pagbank_payment_completed "True" — el pago se ha procesado exitosamente
pagbank_order_id ID del pedido de PagBank (ORDE_…)
pagbank_charge_id ID del cargo de PagBank (CHAR_…)
pagbank_payment_method Método de pago: CREDIT_CARD, DEBIT_CARD, PIX o BOLETO