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ón que creaste para esa integración y te permiten autenticar las operaciones con Mercado Pago de forma segura.
Tipos de credenciales
Las credenciales se dividen en credenciales de prueba y credenciales de producción. Utiliza las credenciales del entorno en el que estés trabajando y reemplázalas únicamente cuando cambies de prueba a producción.
Credenciales de prueba
Las credenciales de prueba permiten configurar y validar la integración sin procesar operaciones reales. Se crean automáticamente junto con la aplicación.
Para consultarlas, sigue estos pasos:
- Accede a Integraciones y selecciona la aplicación.
- Selecciona Prueba en el selector de entorno ubicado en la parte superior de la pantalla.
- Accede a las credenciales por una de las siguientes vías:
- En Inicio, localiza el bloque Credenciales.
- En el menú lateral, selecciona Credenciales.
En ambos casos encontrarás la Public Key y el Access Token del entorno de prueba, con opciones para copiarlos.
| Tipo | Descripción |
| Public Key | Clave pública que se utiliza en el frontend para inicializar la integración y proteger los datos enviados a Mercado Pago. |
| Access Token | Clave privada que se utiliza en el backend para autenticar las solicitudes a las APIs de Mercado Pago. Nunca debe compartirse ni exponerse en el frontend. |
En estas integraciones, el Access Token de prueba comienza con el prefijo APP_USR. Antes de copiar una credencial, verifica que el selector muestre el entorno Prueba.
En la pantalla Credenciales también encontrarás un bloque independiente con los datos de la cuenta de prueba y un acceso para administrarla.
Compartir credenciales
Si otra persona te ayuda a integrar los productos de Mercado Pago, puedes compartir con ella las credenciales de la aplicación de forma segura.
Para iniciar el proceso, sigue estos pasos:
- Accede a Integraciones, selecciona la aplicación y, en el menú lateral, haz clic en Credenciales.
- Selecciona el entorno de Prueba o Producción.
- En la sección Comparte las credenciales con un desarrollador, haz clic en Compartir credenciales.
Puedes deshacer esta acción eliminando la cuenta que recibió las credenciales y renovándolas.
Renovar credenciales
Puedes renovar las credenciales de producción por motivos de seguridad o si necesitas revocar un acceso compartido.
La renovación genera un nuevo par de credenciales. Una vez completada, reemplaza las credenciales anteriores por las nuevas en todos los puntos de la integración donde las utilices.
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:
curlcurl -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.