Para usar Clip en MaviBot, necesitas crear un par de credenciales en tu cuenta de Clip e ingresarlas en la configuración del sistema de pago.

Clip es un servicio de pago mexicano.

Obtención de Credenciales

Firma un acuerdo con Clip y obtén acceso al Panel de Desarrollador en tu cuenta de Clip.

En la sección de credenciales, haz clic en Crear credencial, ingresa un nombre y confirma la creación.

Copia las siguientes credenciales:

  • API key
  • Clave secreta

¡Importante! La clave secreta se muestra solo una vez, inmediatamente después de crear las credenciales. Guárdala en un lugar seguro. No podrás volver a verla en tu cuenta de Clip. Si la pierdes, deberás crear un nuevo par de credenciales.

Las credenciales se crean por separado para los entornos de producción y prueba. Puedes crear hasta 6 aplicaciones por cuenta.

Para pruebas de integración, crea un par de credenciales de prueba. Para aceptar pagos reales, usa las credenciales de producción.

No es necesario configurar una URL de notificación de pago en tu cuenta de Clip. MaviBot envía automáticamente la URL de notificación al crear cada pago.

Conexión de Clip

En la pestaña Adquirencia, selecciona Clip e ingresa:

Campo Descripción
API key Identificador de la aplicación.
Clave secreta Clave secreta de la aplicación.

La conexión está completa.

Generación de un Enlace de Pago

Usa la siguiente función de la Calculadora:

get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)

Parámetros

Parámetro Descripción
amount Monto del pago. Obligatorio. El monto mínimo es 1 en la unidad monetaria principal. Especifica el monto como 100.55, no 10055.
description Descripción del pago. Opcional. Longitud máxima: 250 caracteres. El cliente puede verla en la página de pago y en el recibo.
currency Código de moneda de tres letras (MXN y otras monedas disponibles para tu cuenta de Clip). Opcional. Valor predeterminado: MXN.
customer_email Correo electrónico del cliente. Opcional. Se inserta automáticamente en el formulario de pago.
customer_phone Número de teléfono del cliente. Opcional. Se inserta automáticamente en el formulario de pago.
full_name Nombre del cliente. Opcional. Se inserta automáticamente en el formulario de pago.
product_name Nombre del producto. Opcional.
language Idioma de la página de pago: es para español (predeterminado) o en para inglés.

La función devuelve una URL de pago.

Botón de Enlace de Pago

Para enviar un botón de pago al cliente:

  1. Crea un botón con la función Pagar.
  2. Selecciona Clip como sistema de pago.
  3. Especifica el nombre del producto, el monto y la moneda.
  4. Si es necesario, especifica las variables que contienen el nombre, la dirección de correo electrónico y el número de teléfono del cliente.

Callbacks de Pago

Después de que el cliente siga el enlace de pago y complete el pago, MaviBot recibe un callback.

Pago Exitoso

Ejemplo:

SDJ91MTKTT_success 100.55

Donde:

  • SDJ91MTKTT — los primeros 10 caracteres de tu API key.
  • 100.55 — el monto del pago.

Pago Fallido

Si el pago no es exitoso, se envía el siguiente callback:

SDJ91MTKTT_fail 100.55

¡Importante! Un callback de pago fallido se envía solo después de que el enlace de pago se cierra permanentemente: después de 5 intentos de pago fallidos o cuando el enlace expira.

Mientras el cliente aún tenga intentos de pago disponibles, el enlace permanece activo y no se envía ningún callback de pago fallido.

Variables del Cliente Después de un Pago Exitoso

Variable Descripción
clip_callback_data Información de pago recibida del sistema de pago Clip.
clip_payment_completed "True" si el pago se procesó correctamente.
clip_payment_request_id Identificador del enlace de pago en Clip.
clip_receipt_no Número de recibo de Clip.