Ir al contenido principal
Todas las coleccionesIntegra tu Checkout
PrincipiaPay: cómo integrar su checkout a través de webhook?
PrincipiaPay: cómo integrar su checkout a través de webhook?

En este artículo, mostramos cómo integrar la plataforma de pagos PrincipiaPay con Clint a través de webhook.

Actualizado ayer

PrincipiaPay es una plataforma de pagos especializada en el mercado de educación digital, utilizada por grandes nombres del infoproducto en Brasil. La empresa ha financiado más de 2 mil millones de reales en cursos y ha facilitado el acceso de más de 600 mil estudiantes a la educación, ofreciendo una solución de boletos parcelados de hasta 24 veces que desbloquean ventas, especialmente para estudiantes que no tienen tarjeta de crédito o saldo inmediato en PIX.

¿Cómo integrar PrincipiaPay con Clint?

Para comenzar la integración con PrincipiaPay, primero necesitamos acceder a Clint e iniciar el proceso de integración a través del webhook para copiar el enlace de integración generado, que se utilizará en la configuración de PrincipiaPay.

⚠️Atención: Para acceder al área de webhook en PrincipiaPay, es necesario tener permisos de administrador en la plataforma.

Em Clint

En tu Clint, haz clic en "Más" en la barra superior y luego en "Integraciones".

En el modal que se abrirá, haz clic en "+ Nueva Integración" en la esquina superior derecha.

Selecciona "Webhook".

Haz clic en "Recibir Webhook" y luego en "Comenzar".

En esta página, haz clic en "Negocio" y luego en "Crear o actualizar". Luego, selecciona el origen deseado para los negocios, asigna un nombre a la integración y, por último, copia el enlace generado y haz clic en "Continuar".

Deja esta página abierta en tu navegador y accede a PrincipiaPay para iniciar la integración desde allí.

En PrincipiaPay

Ahora, debemos ingresar en PrincipiaPay para continuar con la integración con Clint. Para ello, accede con tu inicio de sesión y en la página principal de la plataforma haz clic en "Configuraciones".

Haz clic en "Integraciones".

Selecciona "Webhooks".

Haz clic en "+ Crear webhook".

En la página que se mostrará en el lado derecho de la plataforma, ingresa un nombre para identificar la integración en PrincipiaPay, pega la URL generada en Clint y selecciona el tipo de evento que deseas recibir en Clint, como por ejemplo, "Compras expiradas". Finalmente, haz clic en "Crear webhook".

En Clint

Ahora, volvemos a Clint para finalizar la integración. Para ello, haz clic en "Continuar".

Realiza el mapeo de los campos, recordando que a la izquierda están los campos según PrincipiaPay, y a la derecha están los campos de Clint.

A continuación, consulte algunas de las informaciones que es posible traer de PrincipiaPay a Clint:

Propriedad

Tipo

Descripción

buyer.name

Texto

Nome del comprador.

buyer.email

Texto

E-mail del comprador

buyer.phone

Texto

Telefono del comprador (con DDD y sin DDI)

checkout.price

Texto

Valor total de la venta

Después de realizar el mapeo, haz clic en "Continuar".

📌Importante: Para que la integración funcione correctamente y la información se envíe adecuadamente a Clint, es esencial que los campos de PrincipiaPay estén configurados exactamente como se describe en la tabla anterior. Si necesitas información más específica, contacta con el soporte de la plataforma para obtener ayuda con el mapeo.

Elige la etapa en la que deseas que los negocios provenientes de PrincipiaPay sean creados, de acuerdo con la fuente seleccionada al inicio de la integración. También define una etapa para la actualización y el estado en el que el negocio debe ser registrado en Clint. Si lo deseas, puedes agregar una etiqueta personalizada a esos negocios para facilitar la organización. Finalmente, haz clic en "Guardar".

¡Y listo, tu integración ha sido finalizada en Clint 🎉!

Teste la integración:

Para verificar si la integración está funcionando correctamente, regresa a PrincipiaPay y haz clic en "Prueba de configuración".

Seleccione "Enviar teste".

Ahora, regresa a Clint, accede a la fuente en la que realizaste la integración y verifica si el negocio de prueba se ha registrado correctamente en la etapa.

¡Si el negocio con el nombre "John Doe" se ha creado, la integración está funcionando correctamente!


🚨Para cada evento que desees recibir en Clint, como "Tarjeta rechazada", "Abandono de carrito" y otros, es necesario configurar una integración separada, ya que se trata de una integración a través de webhook. Recomendamos crear un origen específico para cada evento que deseas recibir en Clint y configurar una integración individual para cada uno, seleccionando el evento correspondiente en PrincipiaPay, tal como se describe en los pasos de este artículo. 🚨

¿Ha quedado contestada tu pregunta?