Conexión de Telr
Para usar el sistema de pago Telr en MaviBot, necesitas obtener las credenciales de tu tienda desde tu cuenta de Telr e ingresarlas en la configuración del sistema de pago.
Obtención de Credenciales de la Tienda
Firma un acuerdo con Telr y obtén acceso a tu cuenta de comerciante.
En Tiendas → Detalles de la tienda, copia los siguientes valores:
| Campo de Telr | Campo de MaviBot |
|---|---|
| Store ID | Store ID |
| Authentication key | Authentication Key |
Configuración de Notificaciones de Pago
Abre Página de pago (o Seguridad) → Consejo de transacción y especifica la siguiente URL de notificación:
https://chatter.mavibot.ai/telr_callback/result
Selecciona los tipos de transacción para los que deseas recibir notificaciones.
En la misma sección, copia la Clave secreta. Esta clave se utiliza para verificar las firmas de las notificaciones.
¡Importante! La configuración de Consejo de transacción es obligatoria. Sin ella, MaviBot no recibirá notificaciones de pago y no se enviará ningún callback al bot.
Conexión de Telr en MaviBot
Abre Sistemas de pago en la configuración de tu proyecto, selecciona Telr y completa los siguientes campos:
| Campo | Descripción |
|---|---|
| Store ID | Identificador numérico de tu tienda Telr. |
| Authentication Key | Se utiliza para generar enlaces de pago. |
| Secret Key | Se utiliza para verificar las firmas de las notificaciones de pago. Sin ella, las notificaciones de pago serán rechazadas. |
| Test Mode | Habilita pagos de prueba utilizando tarjetas de prueba de Telr sin cobrar fondos reales. Desactiva esta opción para aceptar pagos reales. |
Una vez que todos los campos estén completados, la integración estará lista para usar.
Generación de un Enlace de Pago
Usa la siguiente función de la Calculadora:
get_telr_payment_url(amount, description, currency, product_name)
Parámetros
| Parámetro | Descripción |
|---|---|
amount |
Monto del pago. Requerido. |
description |
Descripción del pago. Opcional. Longitud máxima: 63 caracteres. |
currency |
Código de moneda de tres letras (AED, SAR, USD, EUR, GBP y otras monedas disponibles para tu cuenta de Telr). Opcional. Valor predeterminado: AED. |
product_name |
Nombre del producto. Opcional. |
La función devuelve una URL de pago.
¡Importante! Los enlaces de pago permanecen válidos por un tiempo limitado. Envía el enlace al cliente inmediatamente después de generarlo.
Ejemplo
Botón de Enlace de Pago
Para enviar un botón de pago:
- Crea un botón con la función Pagar.
- Selecciona Telr como sistema de pago.
- Especifica:
- Nombre del producto
- Monto del pago
- Moneda
Callbacks de Pago
Después de que el cliente complete el pago, MaviBot recibe automáticamente un callback.
Pago Exitoso
Ejemplo:
SDJ91MTKTT_success 100
Donde:
-
SDJ91MTKTT— los primeros 10 caracteres de tu Authentication Key. -
100— el monto del pago.
Pago Fallido o Cancelado
Ejemplo:
SDJ91MTKTT_fail 100
Pago en Revisión Bancaria
Si un pago está autorizado pero puesto en espera por el banco para verificación adicional, no se envía ningún callback hasta que se complete la revisión.
Una vez que el banco aprueba o rechaza la transacción, Telr envía una notificación y el callback se entrega a MaviBot automáticamente.
Variables del Cliente Después de un Pago Exitoso
| Variable | Descripción |
|---|---|
telr_callback_data |
Información de pago recibida del sistema de pago Telr. |
telr_payment_completed |
"True" si el pago se ha procesado exitosamente. |
telr_tran_ref |
Referencia de transacción de Telr (tran_ref). |