Mercado Pago

Comienza con Mercado Pago

Esta página provee una guía comprensiva para integrar Mercado Pago con DEUNA.

Cómo funciona

Mercado Pago te permite ofrecer a tus clientes la opción de guardar su tarjeta para facilitar futuras compras.

Mercado Pago tokeniza tarjetas mediante API o el widget. DEUNA usa esta solución para tokenizar y almacenar tarjetas en el vault.

Valida que la tarjeta esté operativa antes de almacenar la tarjeta en Mercado Pago.

Puedes realizar la validación dos maneras:

• Zero dollar auth
• Cobro con monto mínimo

Zero dollar auth

La validación zero dollar auth consiste en realizar un cobro de validación con monto cero.

Esta operación sólo se encuentra disponible con Visa y Mastercard para Argentina y Brasil.

📘

Mercado Pago irá ampliando esta operación para incluir más sitios y franquicias.

Cobro con monto mínimo

La validación cobro con monto mínimo consiste en realizar un cobro de validación con un monto bajo, que es reembolsado de inmediato.

Esta operación está disponible para las franquicias y países donde Zero dollar auth no esté disponible

📘

Los montos mínimos se definen por país y franquicia de tarjeta, pero también puede ser decididos por el comercio.

Requerimientos

El requerimiento para integrar Mercado Pago es tener una cuenta de vendedor en Mercado Pago o Mercado Libre.

Integra Mercado Pago

Ahora que se estableceron los requisitos técnicos, puedes comenzar la integración.

1. Activa el webhook de Mercado Pago

Para activar la tokenización con Mercado Pago primero debemos activar la validación del webhook de Mercado Pago.

Qué es el Webhook

Un webhook es una herramienta que facilita la recepción de notificaciones en tiempo real cada vez que se produce un evento específico.

Para certificar que Mercado Pago sea el origen de estas notificaciones, se ha implementado una validación de las request que llegan a nuestro webhook.

2. Valida el webhook

Mercado Pago siempre nos enviará una clave secreta en las request que envíen a nuestro webhook, lo que nos permitirá validar el origen de la misma.

3. Obten la URL del webhook

Comunícate con el equipo de DEUNA para solicitar la URL del webhook de Mercado Pago.

4. Configura el webhook:

Configura el webhook desde el panel de desarrolladores de Mercado Pago. Para hacerlo deberás hacer lo siguiente:

1. Ingresa al panel de desarrolladores y selecciona tu integración.

   

   
   

2. En el menú de la izquierda, selecciona Webhooks.

   

   
   

3. Haz click en Configurar notificaciones.

   

4. En Modo producción, ingresa la url que te proporcionamos .

5. Selecciona los eventos Pagos y Alertas de fraude

6. Haz click en guardar configuración.

5. Obtén el secret key

En la sección de webhooks, debes obtener tu clave secreta para operar.

1. Obtén el secret key dando click en el botón de contraseña.

2. Envía el secret key obtenido al equipo de DEUNA.

3. Nosotros nos encargaremos de realizar las configuraciones necesarias.

   

6. Activa la tokenización en PSP

Una vez que el equipo de DEUNA confirme que todas las configuraciones necesarias se han completado exitosamente, debemos realizar la activación de la tokenización en PSP.

1. Ingresa al ADMIN
2. Ve a Conexiones y busca la configuración de Mercado Pago
3. Activa el check de guardar tarjetas en el PSP
4. Haz click en editar.

7. Corrobora la validación

Cuando la tokenización con Mercado Pago se realiza correctamente:

1. Llega respuesta del endpoint Crear una tarjeta.
2. El atributo vault.provider tiene el valor Mercadopago.

"vault": {
	"provider": "Mercadopago",
	"id": "id of the vault provider"
}

3. El atributo verified_by contiene los posibles métodos de validación.

"data": {
  "verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}

📘

Una vez que la tarjeta ha sido tokenizada con éxito y se ha recibido el ID en respuesta de Crear una Tarjeta, el comercio puede realizar cobros enviando el card_id sin necesidad de enviar el CVV para completar la transacción. Revisar ejemplos en Purchase V1 y Purchase V2.