Conexión de PayTabs con Mavibot
Para conectar PayTabs con Mavibot, debes configurar varios ajustes en tu cuenta de PayTabs.
1. Crear una clave API
En tu panel de PayTabs, ve a:
Developers → API Keys
Crea una nueva clave API.
Después de crear la clave API, guarda los siguientes detalles:
- Server Key — necesaria para configurar la integración.
- Profile ID — también necesario para la configuración de la conexión.
2. Configurar notificaciones de pago
Ve a:
Developers → Configuration
Habilita las notificaciones de pago (callbacks).
Haz clic en "+" y agrega la siguiente URL de callback:
https://chatter.mavibot.ai/paytabs_callback/result
Esta URL se utiliza para enviar actualizaciones del estado del pago a Mavibot.
3. Configurar PayTabs en Mavibot
En la configuración de Mavibot:
- Ve a la sección Acquiring
- Selecciona PayTabs como proveedor de pago
- Ingresa los siguientes detalles:
- Profile ID
- Server Key
- Selecciona la región de tu cuenta de PayTabs
¡Ten en cuenta!
La región seleccionada debe coincidir con la región donde está registrada tu cuenta de PayTabs.
Una vez guardados los ajustes, la configuración de la integración estará completa.
Generar un enlace de pago
Para generar un enlace de pago, utiliza 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 | Monto del pago. Parámetro obligatorio. |
| description | Descripción del pago. Parámetro opcional. |
| currency | Moneda del pago. Parámetro opcional. |
| customer_email | 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
Los siguientes códigos de moneda son compatibles:
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 parámetro currency, 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:
- Crea un botón con el tipo Payment
- Selecciona PayTabs como proveedor de pago
- Especifica:
- la descripción del pago;
- el monto del pago;
- la moneda.
Manejo 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 la Server Key
- 100 — el monto del pago
Para crear una acción para un pago exitoso, ve a Builder y crea un bloque con un disparador (puede ser un bloque Start o un bloque Trigger).
Luego, en el campo Trigger, ingresa:
- el valor completo del callback (si deseas activar la acción solo para un monto de pago específico), o
- solo el valor del callback antes del monto del pago (si deseas activar la acción para todos los pagos exitosos).
Pago fallido
Ejemplo:
SDJ91MTKTT_fail 100
El manejo de pagos fallidos se configura de la misma manera que el manejo de pagos exitosos.
Crea un bloque con un disparador e ingresa 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 exitosamente.