Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

EBANX

Para usar la plataforma de pago de EBANX en Mavibot, necesitas obtener tu Clave de integración de 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 a los clientes se les muestran 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).

Obtención de la Clave de integración

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

Durante el proceso de incorporación, selecciona los países en los que quieres 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 Clave de integración. La necesitarás para conectar EBANX con Mavibot.

Para fines de prueba, EBANX proporciona una cuenta sandbox separada con su propia Clave de integración. Consulta el Modo de prueba más abajo.

Conexión de EBANX

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

  • Clave de integración — tu Clave de integración de EBANX copiada.

  • País — 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.

  • Modo de prueba — habilita esta opción para probar la integración usando el entorno sandbox de EBANX. Cuando el Modo de prueba esté habilitado, usa la Clave de integración de tu cuenta sandbox. Para aceptar pagos reales, desactiva el Modo de prueba y usa tu Clave de integración real.

La configuración ya está completa.

Generación de un enlace de pago

Función de la calculadora:

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

Parámetros

  • amount — importe del pago. Requerido.

  • customer_email — dirección de correo electrónico del cliente. Requerido. EBANX no puede crear un pago sin ella. 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 cualquiera de las siguientes:

    • la moneda local del país de pago (como BRL, MXN, COP, CLP, PEN, ARS, etc.), o

    • la moneda de tu cuenta de EBANX (normalmente USD), en cuyo caso EBANX convertirá el importe 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;

  • importe del pago;

  • moneda;

  • variables que contienen 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 Start .

El bloque Start se usa normalmente 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 entre el segundo y el tercer bloque. 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:

Si deseas aceptar pagos en una moneda distinta de 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 Billing .

  • Selecciona EBANX como proveedor de pagos.

Luego ingresa lo siguiente:

  • Nombre del producto.

  • Importe del pago.

  • Moneda (opcional).

  • Nombre completo del cliente (opcional). Puedes configurarlo de la misma manera en 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, la siguiente callback se envía a la conversación tras un pago exitoso:

Donde:

  • SDJ91MTKTT son los primeros 10 caracteres de tu Clave de integración.

  • 100 es el importe del pago.

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

Para métodos de pago offline (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 tardar de 1 a 3 días hábiles. El callback se entregará automáticamente una vez que el pago haya sido confirmado.

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 importe del pago — si quieres reaccionar a cada pago.

En este caso, el Tipo de coincidencia debe establecerse en Por palabras clave.

Como alternativa, ingresa el texto completo del callback en el campo Disparador si quieres reaccionar a un pago específico. En este caso, el Tipo de coincidencia debe establecerse en Coincidencia exacta.

Si quieres continuar el flujo de trabajo después de un pago exitoso, puedes crear un Start bloque en lugar de un Disparador bloque 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 de la pasarela de pagos

ebanx_payment_completed

"True" — el pago se procesó como exitoso

ebanx_payment_hash

Identificador del pago en EBANX (hash)

AnteriorCoinpaymentsSiguienteINXY Payments

Última actualización