Saltar al contenido principal
En esta página

Comienza con Mercado Pago#

Esta página proporciona una guía completa 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 widget. DEUNA utiliza esta solución para tokenizar y almacenar tarjetas en la bóveda.

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

Puede realizar la validación de dos maneras:

  • Autenticación de cero dólares
  • Cobrar con importe mínimo

Autenticación de cero dólares

El autenticación de cero dólares La validación consiste en realizar un cargo de validación con importe cero.

Esta operación sólo está disponible con Visa y Mastercard para Argentina y Brasil.

Cobrar con importe mínimo

El cobrar con cantidad mínima La validación consiste en realizar un cargo de validación con un importe reducido, el cual se reembolsa inmediatamente.

Esta operación está disponible para franquicias y países donde la autenticación cero dólares no está disponible.

Requisitos#

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

Integrar Mercado Pago

Ahora que se han establecido los requisitos técnicos, puede 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 recibir notificaciones en tiempo real cada vez que ocurre un evento específico.

Para certificar que Mercado Pago es el origen de estas notificaciones, se deberá realizar una validación del requests que llegan a nuestro webhook ha sido implementado.

2. Validar el webhook

Mercado Pago siempre nos enviará una clave secreta en el requests envían a nuestro webhook, lo que nos permitirá validar el origen del mismo.

3. Obtenga la URL del webhook

Contacta al equipo de DEUNA para solicitar la URL del webhook de Mercado Pago.

4. Configure el webhook:

Configurar el webhook desde Mercado Pago panel de desarrollador. Para ello debes hacer lo siguiente:

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


  2. En el menú de la izquierda, seleccione Ganchos web.


  3. Haga clic en Configurar notificaciones.

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

  5. Seleccione los eventos Payments y Fraud alerts

  6. Haga clic en guardar configuración.

5. Obtén la clave secreta

En la sección de webhooks deberás obtener tu clave secreta para operar.

  1. Obtener el clave secreta haciendo clic en el botón de contraseña.

  2. Enviar la clave secreta obtenida al equipo de DEUNA.

  3. Nosotros nos encargaremos de realizar las configuraciones necesarias.

6. Activar la tokenización en PSP

Una vez que el equipo de DEUNA confirme que todas las configuraciones necesarias se han completado con éxito, debemos activar la tokenización en PSP.

  1. Introduzca el ADMIN
  2. Ve a Conexiones y busca la configuración de Mercado Pago
  3. Activar el guardar tarjetas en psp casilla de verificación
  4. Haga clic en editar.

7. Verificar la validación

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

  1. La respuesta llega desde el crear una tarjeta endpoint.
  2. El vault.provider el atributo tiene el valor Mercadopago.
JSON
"vault": {
	"provider": "Mercadopago",
	"id": "id of the vault provider"
}
  1. El verified_by El atributo contiene los posibles métodos de validación.
JSON
"data": {
  "verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}

Observación:#

  • El external_reference El campo debe cumplir con los siguientes requisitos:
    • Longitud máxima: 64 caracteres
    • Caracteres permitidos: caracteres alfanuméricos (letras y números), guiones (-) y guiones bajos (_)
    • Restricción: No se permiten caracteres especiales como el símbolo de almohadilla (#), paréntesis, corchetes u otros símbolos de puntuación.