Credenciales
Las credenciales son claves de acceso únicas con las que identificamos una integración en tu cuenta. Están directamente vinculadas a la aplicaciónEntidad registrada en Mercado Pago que actúa como un identificador para gestionar tus integraciones. Para más información, accede al enlace a continuación.Detalles de la aplicación que creaste para esa integración, y te permitirán desarrollar tu proyecto contando con las mejores medidas de seguridad de Mercado Pago.
Tipos de credenciales
Las credenciales están divididas en dos tipos, credenciales de prueba y credenciales de producción. A continuación, te explicamos de qué se tratan.
Credenciales de prueba
Las credenciales de prueba son un conjunto de claves que se utilizan tanto en la etapa de desarrollo, para garantizar configuraciones seguras, como en la etapa de pruebas, para probar la integración.
Durante el proceso de integración, utiliza credenciales de prueba para realizar todas las configuraciones y validaciones necesarias, asegurando que no se efectúen pagos reales en producción. Estas credenciales simulan la información de una cuenta productiva, pero en un entorno seguro de pruebas. Mantén el uso de las credenciales de prueba durante toda la fase de desarrollo. Solo cámbialas por las credenciales productivas cuando el sistema esté completamente validado y listo para ser publicado.
Al crear una aplicación, tus credenciales de prueba se generarán automáticamente. Si esto no sucede, solo tienes que hacer clic en Activar credenciales en los dados de la integración correspondiente o como te indicamos a continuación.
- En Tus integraciones, selecciona tu aplicación. Luego, dirígete a la sección Pruebas y haz clic en Credenciales de prueba en el menú a la izquierda de la pantalla.
- Acepta la Declaración de Privacidad y los Términos y condiciones. Completa el reCAPTCHA y haz clic en Activar credenciales.
Al acceder a las credenciales de prueba, se mostrará el par de credenciales Public Key y Access Token.
Public Key y Access Token
Las credenciales Public Key y Access Token de prueba se utilizan al igual que las credenciales productivas, pero no permitirán realizar ninguna transacción real. En algunas integraciones serán requeridas durante la etapa de desarrollo para simular transacciones y verificar que tu integración funcione correctamente.
| Tipo | Descripción |
| Public Key | La clave pública de la aplicación se utiliza generalmente en el frontend. Permite, por ejemplo, acceder a información sobre los medios de pago y cifrar los datos de la tarjeta. Este tipo de llave es la única que puede ser utilizada del lado público de tu integración. |
| Access Token | Clave privada de la aplicación que siempre se debe utilizar en el backend para generar pagos. Nunca deberá ser expuesta en un parámetro o del lado público de la integración. |
Compartir credenciales
Si estás desarrollando para otra persona o recibes ayuda en la integración o configuración de tus tiendas, podrás compartir las credenciales de forma segura con otra cuenta de Mercado Pago.
Puedes compartir las credenciales hasta un máximo de 10 veces. Si alcanzas este límite, deberás eliminar permisos antiguos, sin impacto en las integraciones ya configuradas.
Además, si por cuestiones de seguridad no deseas seguir compartiendo tus credenciales, puedes cancelar el acceso.
A continuación, te mostramos cómo compartir credenciales.
- En la esquina superior derecha de Mercado Pago Developers, haz clic en Ingresar e ingresa los datos requeridos con la información correspondiente a tu cuenta de Mercado Pago. Luego, haz clic en el botón Tus integraciones ubicado en la esquina superior derecha.
- Accede a la aplicación de la integración para la cual necesitas compartir las credenciales.
- Ve a la sección Pruebas o Producción, según el tipo de credencial que desees compartir. Recuerda que para acceder a las credenciales de producción, deberás activarlas. Si no sabes cómo activarlas, ve a Activar credenciales de producción.
- Una vez seleccionas las credenciales, dirígete a la sección Comparte las credenciales con un desarrollador y haz clic en el botón Compartir Credenciales.
- Ingresa el correo electrónico de la persona a la que deseas concederle acceso. Recuerda: es obligatorio que el correo electrónico esté asociado a una cuenta de Mercado Pago.
Renovar credenciales
Puedes renovar tus credenciales de producción por motivos de seguridad o cualquier otra razón relevante.
Para renovar un par de credenciales, sigue los pasos a continuación.
- Accede a tus credenciales de producción a través de Tus integraciones.
- Selecciona el par de credenciales que quieres renovar. Estas pueden ser Public Key y Access Token o Client ID y Client Secret. Ten en cuenta que se renovarán ambas credenciales del par que elijas.
- Haz clic en los tres puntos ubicados a la derecha de la credencial que quieras renovar y selecciona Renovar. Haz clic en Renovar ahora para confirmar el cambio.
Listo, tus credenciales ya fueron renovadas.
Recomendaciones de seguridad
Al integrar las soluciones de Mercado Pago, manejarás datos sensibles que deberás proteger de posibles pérdidas o vulnerabilidades, tales como tus credenciales de acceso a Mercado Pago, las claves que utilizas en tus integración o la información de tus clientes.
Te mostraremos cómo puedes optimizar la seguridad de tus integraciones de manera simple y rápida.
Envía el Access Token por header
Cada vez que realices llamadas a la API, envía el Access Token por header en lugar de hacerlo por query param. Esto te permitirá resguardarlo para que no sea expuesto a cualquier persona ajena a tu integración.
Por ejemplo, si realizas un llamado GET al recurso /users/me, sería de esta manera:
curl
curl -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ https://api.mercadolibre.com/users/me
Utiliza OAuth para gestionar las credenciales de terceros
OAuth es un protocolo de autorización que permite a aplicaciones acceder de forma segura a cuentas de usuario en servicios HTTP sin necesidad de que ese usuario comparta sus credenciales directamente. Funciona como un intermediario que facilita el acceso controlado a datos de usuario por parte de aplicaciones de terceros.
Para más información, accede a la documentación.