Para utilizar la plataforma de pagos EBANX en Mavibot, necesitas obtener tu Integration Key desde tu cuenta de EBANX e ingresarla en la configuración de pagos.

EBANX es un agregador de métodos de pago locales en toda América Latina. Los pagos se procesan en una página de pago segura alojada por EBANX, donde se muestran a los clientes los métodos de pago disponibles en su país (como PIX y boleto en Brasil, OXXO y SPEI en México, PSE en Colombia, tarjetas de crédito/débito y más).

Obteniendo la Integration Key

Firma un acuerdo con EBANX y obtén acceso al Portal de Negocios de EBANX (tu panel de comerciante).

Durante el proceso de incorporación, selecciona los países donde deseas aceptar pagos. Los clientes solo podrán pagar desde los países habilitados en tu cuenta de EBANX.

En la configuración de integración, copia tu Integration Key. La necesitarás para conectar EBANX con Mavibot.

Para fines de prueba, EBANX proporciona una cuenta sandbox separada con su propia Integration Key. Consulta el Modo de Prueba a continuación.

Conectando EBANX

En la configuración de Sistemas de Pago, selecciona EBANX e ingresa lo siguiente:

  • Integration Key — tu Integration Key de EBANX copiada.
  • Country — el país de pago predeterminado (código de país de dos letras en minúsculas: br para Brasil, mx para México, co para Colombia, cl para Chile, pe para Perú, ar para Argentina, etc.). Esto determina qué métodos de pago verán los clientes en la página de pago. El país seleccionado debe estar habilitado en tu cuenta de EBANX.
  • Test Mode — habilita esta opción para probar la integración usando el entorno sandbox de EBANX. Cuando el Modo de Prueba esté habilitado, usa la Integration Key de tu cuenta sandbox. Para aceptar pagos reales, deshabilita el Modo de Prueba y usa tu Integration Key en vivo.

La configuración ahora está completa.

Generando un Enlace de Pago

Función de calculadora:

get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Parámetros

  • amount — monto del pago. Requerido.

  • customer_email — dirección de correo electrónico del cliente. Requerido. EBANX no puede crear un pago sin esto. El cliente también recibirá una confirmación de pago en esta dirección de correo electrónico.

  • full_name — nombre completo del cliente. Requerido.

  • description — descripción del pago. Opcional.

  • currency — moneda del pago. Puedes usar:

    • la moneda local del país de pago (como BRL, MXN, COP, CLP, PEN, ARS, etc.), o
    • la moneda de tu cuenta de EBANX (típicamente USD), en cuyo caso EBANX convertirá el monto usando su tipo de cambio.

    Opcional. El valor predeterminado es USD.

  • country — país de pago (código de país de dos letras en minúsculas). Opcional. Si se omite, se usará el país predeterminado especificado en la configuración de pago.

La función devuelve una URL de pago.

Nota: La moneda seleccionada debe ser compatible con el país de pago. Debe ser la moneda local del país o la moneda de tu cuenta de EBANX. Por ejemplo, para br (Brasil), BRL y USD son válidos, mientras que MXN no lo es.

Botón de Enlace de Pago

Para enviar un botón de pago, selecciona el tipo Botón de Pago y elige EBANX como sistema de pago.

Ingresa:

  • nombre del producto;
  • monto del pago;
  • moneda;
  • variables que contengan el nombre completo y la dirección de correo electrónico del cliente.

Opcionalmente, especifica el país de pago.

Ejemplo 1: Configuración del Flujo de Trabajo

Paso 1. Crea un bloque Inicio.

El bloque Inicio se usa típicamente para mostrar el primer mensaje de bienvenida en el flujo de trabajo, junto con cualquier información introductoria que el usuario necesite.

Paso 2. Crea el bloque que se muestra a continuación.

Paso 3. Ve a la configuración de Conexión.

Necesitarás la siguiente expresión regular para verificar que el cliente haya ingresado una dirección de correo electrónico válida:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Además, habilita la opción El usuario ingresa datos e ingresa customer_email.

Paso 4. Ingresa el mensaje en el segundo bloque.

Paso 5. Crea un tercer bloque y abre la configuración de Conexión entre el segundo y el tercer bloque.

Habilita el temporizador para avanzar automáticamente al siguiente bloque.

Paso 6. En el tercer bloque, ingresa la función en la Calculadora.

Ejemplo para copiar:

amount = 1000
description = "Product1 is product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

Si deseas aceptar pagos en una moneda diferente a USD, especifica la moneda como se muestra a continuación.

Ejemplo 2. Botón de Facturación

Este ejemplo es casi idéntico al Ejemplo 1.

Sin embargo, en lugar de crear un tercer bloque con una función para generar el enlace de pago, puedes crear un botón en el segundo bloque.

En la ventana que se abre:

  • Ingresa el texto del botón.
  • Selecciona la función Facturación.
  • Selecciona EBANX como proveedor de pago.

Luego ingresa lo siguiente:

  • Nombre del Producto.
  • Monto del Pago.
  • Moneda (opcional).
  • Nombre Completo del Cliente (opcional). Puedes configurarlo de la misma manera que configuraste la entrada de correo electrónico del cliente.
  • Correo Electrónico del Cliente — ingresa la variable #{customer_email}.

Luego haz clic en Agregar.

Notificaciones Después del Pago

Después de que el cliente abra el enlace de pago y complete el pago, se envía el siguiente callback a la conversación tras un pago exitoso:

SDJ91MTKTT_success 100

Donde:

  • SDJ91MTKTT son los primeros 10 caracteres de tu Integration Key.
  • 100 es el monto del pago.

Si el pago se cancela, se envía el siguiente callback:

SDJ91MTKTT_fail 100

Para métodos de pago fuera de línea (como boleto, OXXO, etc.), la confirmación del pago no es inmediata. EBANX envía el callback solo después de recibir los fondos, lo que puede tomar de 1 a 3 días hábiles. El callback se entregará automáticamente una vez que se haya confirmado el pago.

Cómo Enviar una Respuesta a un Pago Exitoso o Fallido

Paso 1. Crea un bloque Disparador.

Paso 2. En el campo de condición, ingresa el texto de notificación SDJ91MTKTT_success — sin el monto del pago — si deseas reaccionar a cada pago.

En este caso, el Tipo de Coincidencia debe configurarse como Por Palabras Clave.

Alternativamente, ingresa todo el texto del callback en el campo Disparador si deseas reaccionar a un pago específico. En este caso, el Tipo de Coincidencia debe configurarse como Coincidencia Exacta.

Si deseas continuar el flujo de trabajo después de un pago exitoso, puedes crear un bloque Inicio en lugar de un bloque Disparador y continuar construyendo el flujo de tu bot desde allí.

Variables del Cliente Después de un Pago Exitoso

Variable Valor
ebanx_callback_data Información del pago recibida del sistema de pago
ebanx_payment_completed "True" — el pago se procesó como exitoso
ebanx_payment_hash Identificador del pago en EBANX (hash)