Paytabs

Conectando PayTabs a Mavibot

Para conectar PayTabs con Mavibot, debes configurar varios ajustes en tu cuenta de PayTabs.

1. Crear una clave API

En tu panel de control de PayTabs, ve a:

Desarrolladores → Claves API

Crea una nueva clave API.

Después de crear la clave API, guarda los siguientes datos:

• Clave del servidor — requerida para configurar la integración.

• ID de perfil — también requerido para la configuración de la conexión.

2. Configurar las notificaciones de pago

Ve a:

Desarrolladores → Configuración

Activa las notificaciones de pago (callbacks).

Haz clic en "+" y añade la siguiente URL de callback:

https://chatter.mavibot.ai/paytabs_callback/result

Esta URL se usa para enviar actualizaciones del estado del pago a Mavibot.

3. Configurar PayTabs en Mavibot

En la configuración de Mavibot:

1. Ve a la Adquirencia sección

2. Selecciona PayTabs como proveedor de pagos

3. Introduce los siguientes datos:

   • ID de perfil

   • Clave del servidor

4. Selecciona tu región de la cuenta de PayTabs

¡Ten en cuenta! La región seleccionada debe coincidir con la región en la que está registrada tu cuenta de PayTabs.

Una vez guardados los ajustes, se completará la configuración de la integración.

Generar un enlace de pago

Para generar un enlace de pago, usa la siguiente función:

get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)

Parámetros de la función

Parámetro	Descripción
! amount	Importe del pago. Parámetro obligatorio
description	Descripción del pago. Parámetro opcional
currency	Moneda del pago. Parámetro opcional
customer_email	Dirección de correo electrónico del cliente. Parámetro opcional
customer_phone	Número de teléfono del cliente. Parámetro opcional
full_name	Nombre completo del cliente. Parámetro opcional
language	Idioma de la página de pago. Parámetro opcional

Monedas disponibles

Se admiten los siguientes códigos de moneda:

SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD

Idiomas disponibles

en — Englishar — Arabicfr — French

La función devuelve una URL de pago.

Si no se proporciona el currency parámetro, la moneda se seleccionará automáticamente según la región configurada.

Usar el enlace de pago en un botón

Para enviar un botón de pago a un cliente:

1. Crea un botón con el Pago tipo

2. Selecciona PayTabs como proveedor de pagos

3. Especifica:

   • descripción del pago;

   • importe del pago;

   • moneda.

---

Gestión del estado del pago

Después de que el cliente abra el enlace de pago y complete el pago, se enviará un evento de callback a la conversación.

Pago exitoso

Ejemplo:

SDJ91MTKTT_success 100

Donde:

• SDJ91MTKTT — los primeros 10 caracteres de Clave del servidor

• 100 — el importe del pago

Para crear una acción para un pago exitoso, ve a Builder y crea un bloque con un disparador (esto puede ser un bloque Start o un bloque Trigger ).

Luego, en el campo Trigger introduce:

• el valor completo del callback (si quieres activar la acción solo para un importe de pago específico), o

• solo el valor del callback antes del importe del pago (si quieres activar la acción para todos los pagos exitosos).

El bloque "Start"

El bloque "Trigger"

Pago fallido

Ejemplo:

SDJ91MTKTT_fail 100

La gestión de pagos fallidos se configura de la misma manera que la de pagos exitosos.

Crea un bloque con un disparador e introduce el valor del callback en el campo Trigger . Esto te permite definir acciones que se ejecutarán cuando un pago falle.

Variables guardadas después de un pago exitoso

Después de un pago exitoso, las siguientes variables se guardan automáticamente para el cliente:

paytabs_callback_data Contiene la carga útil completa del webhook recibida del sistema de pago.

paytabs_payment_completed

Valor:

True

Indica que el pago se ha completado con éxito.