Treli permite agregar metacampos personalizados a las páginas de pago para capturar y registrar información adicional en cada transacción. Estos metacampos se envían a través de la URL y se almacenan en la metadata del cobro, sin interferir con el proceso de pago. Son una herramienta poderosa para integraciones, análisis o personalización avanzada.
En este tutorial aprenderás a:
Activar y configurar metacampos personalizados en Treli.
Utilizar los metacampos en la URL de una página de pago.
Visualizar la información almacenada en cada cobro.
1. ¿Qué son los metacampos y para qué sirven?
Los metacampos son parámetros que puedes enviar junto a una solicitud de pago en Treli. Se usan para asociar valores personalizados a cada transacción, como identificadores de usuarios, campañas, referencias internas, entre otros.
Por ejemplo:
https://pay.treli.co/p/abc123?user_id=7890&campaign=ads_q1
En este caso:
user_id=7890te permite identificar al cliente.campaign=ads_q1indica que el pago proviene de una campaña específica.
Estos datos quedan registrados en la metadata del cobro y pueden consultarse más adelante para fines de análisis, conciliación o soporte.
2. Cómo activar y configurar metacampos en Treli
Paso 1: Accede a la configuración del checkout
Inicia sesión en tu cuenta de Treli.
Dirígete a Configuraciones > Pagos > Checkout.
Desplázate hasta la sección Metacampos.
Haz clic en “+ Añadir metacampo”.
Paso 2: Define tus metacampos personalizados
Escribe la clave del metacampo que deseas habilitar.
Ejemplos comunes:
user_idorder_idcampaign_sourceplan_name
Si deseas agregar más metacampos, repite el proceso con “+ Añadir metacampo”.
Los metacampos no aparecen por defecto en la página de pagos si no están definidos previamente en esta sección.
Haz clic en Guardar cambios.
3. Cómo enviar metacampos desde la URL
Una vez configurados, puedes usarlos en los enlaces de pago que compartas. Agrega los parámetros deseados después del símbolo ? en la URL del cobro.
Ejemplo:
https://pay.treli.co/p/ABCD1234?user_id=juan45&campaña=emailmarzo
Esto permite que los valores se registren automáticamente en la metadata del cobro, sin que el cliente tenga que ingresarlos manualmente.
4. Cómo visualizar los metacampos en Treli
Paso 1: Accede a un cobro o suscripción
Desde el menú lateral, ve a Cobros o Suscripciones.
Busca la transacción asociada al enlace de pago que contenía metacampos.
Haz clic sobre la transacción para abrir sus detalles.
Paso 2: Verifica los metacampos registrados
En la parte inferior del detalle del cobro, encontrarás la sección de Metadata. Allí se mostrarán todos los metacampos enviados desde la URL.
Si no ves los metacampos, asegúrate de haberlos configurado en Treli y de que la URL contenga correctamente los parámetros.
Consideraciones adicionales
Puedes eliminar un metacampo en cualquier momento desde la configuración, pero los datos ya registrados no se borrarán.
Los metacampos son invisibles para el cliente: funcionan en segundo plano para registrar información útil.
No reemplazan los campos visibles del checkout. Para solicitar información al cliente directamente, considera usar [campos personalizados en el checkout].
El uso de metacampos en Treli te permite enriquecer cada transacción con información clave para tu operación. Ya sea para análisis, trazabilidad o integraciones, esta funcionalidad te da mayor control sobre los datos sin friccionar la experiencia del usuario.