En esta documentación se encuentran detallados todos los pasos que deben realizarse para configurar la integración de Vor-Tex con Mercado Pago:
Crear la aplicación
Obtención de credenciales y tarjetas de prueba
Obtener credenciales de producción
Configurar webhooks
Configurar integración en Vor-Tex
Esta documentación complementa a la documentación Monetización de APIs
En primer lugar se debe ingresar a https://www.mercadopago.com.ar/developers/es con las credenciales de Mercado Pago y luego a Tus integraciones, que se encuentra a la derecha de la barra superior.
En la sección de Tus integraciones hacer clic sobre el botón Crear aplicación.Nombre de aplicación: un nombre que la identifique, por ejemplo: Vor-Tex APIs.
¿Qué tipo de solución de pagos vas a integrar?: Seleccionar “Pagos online”.
¿Estás usando una plataforma de e-commerce?: Seleccionar “No”.
¿Qué producto estás integrando? Seleccionar “Suscripciones”.
Modelo de integración: Seleccionar “Suscripcionesconplanasociado”.
Una vez creada la aplicación es posible conocer la información general, sus detalles y acceder a las credenciales.
Las credenciales de prueba permiten integrarse con Mercado Pago en un entorno de pruebas, para poder realizar pruebas sin necesidad de aplicar pagos reales.
Para acceder a las credenciales de prueba se debe hacer clic en Credenciales de prueba.
Luego será necesario copiar la Public Key y Access Token para utilizarlo en Vor-Tex.
Si configuras en Vor-Tex la integración con cuentas de prueba, deberás utilizar las Cuentas de prueba.
Para conocer estas cuentas debes ingresar a Cuentas de prueba.El uso de tarjetas permitirá más fácilmente reproducir casos donde el pago sea Aprobado, Rechazado, Pendiente y otros.
Las credenciales de producción se utilizarán para el entorno productivo y, por tanto, para pagos reales en Mercado Pago.
Para acceder a las credenciales de producción se debe hacer clic en Credenciales de producción.
Luego se debe copiar la Public Key y Access Token para utilizar en Vor-Tex.
Recomendación: guardar estos datos de manera segura y no compartir con personas no autorizadas.
Un webhook es un mecanismo que permite que una aplicación envíe información a otra de forma automática y en tiempo real. Funciona como una "notificación inversa": en lugar de que una aplicación consulte constantemente un servidor para buscar actualizaciones, el servidor envía una notificación a la aplicación cuando ocurre un evento específico.
En este caso, Mercado Pago es el servidor y Vor-Tex la aplicación que será notificada.
Un webhook se configura proporcionando una URL a la que el servidor enviará los datos cuando se dispare el evento. Por ejemplo, al recibir un pago, Mercado Pago ejecutará un webhook a Vor-Tex para informarlo.
Para configurar este tipo de integración se debe ingresar a Webhooks en el menu de opciones que se encuentra a la izquierda:
Para configurar la integración de Mpercado Pago con Vor-Tex, se deben deben ingresar las credenciales obtenidas en Mercado Pago en la plataforma de Vor-Tex.
Para ello, se debe ingresar a Configuraciones > Monetización y seleccionar Mercado Pago como proveedor de Pagos.
En segundo lugar, se deben ingresar las credenciales obtenidas en Mercado Pago en el formulario “Proveedor de Pagos” y finalmente hacer clic en Guardar.
Luego debes hacer clic en Configurar notificaciones y se mostrará el formulario que se comparte a continuación, que hace posible la configuración de los los webhooks para el entorno de prueba y el entorno productivo de forma diferenciada.
Para cada caso es necesario completar:
URL: es la dirección URL de Vor-Tex donde se recibirá la notificación. La URL dependerá de si su cuenta de Vor-Tex se encuentra en servidores propios o en la nube de Vor-Tex. La URL será {{entorno}}/monetization/v1/mercado-pago/webhook.
Eventos: debe seleccionar Pagos y Planes y suscripciones. Puede seleccionar todos los disponibles si lo desea.