Requisitos previos para integrarte

Glosario

Sabemos que algunos términos son nuevos. Antes de empezar, te los dejamos a mano.

Término	Descripción
Credenciales (Credentials)	Tus credenciales son las claves que te proporcionamos para que puedas configurar tus integraciones. Para poder encontrarlas, ve a tus credenciales y selecciona las productivas.
`ACCESS_TOKEN`	Es la clave privada de la aplicación para generar pagos, dentro de la sección credenciales. Debes usarla para identificarte en tus integraciones. Siempre usa las del Modo Producción.
`USER_ID`	ID de la cuenta de Mercado Pago. Se compone por los últimos dígitos del `access_token` posteriores al último guión medio. Entonces, por ejemplo, si tu `access_token` es APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-446566691, entonces tu `USER_ID` es 446566691. También lo puedes encontrar como `COLLECTOR_ID`.
`SPONSOR_ID`	Es el `USER_ID` del usuario proveedor del sistema integrado con Mercado Pago. Se compone por los últimos dígitos del `access_token` posteriores al último guión medio. Entonces, por ejemplo, si tu `access_token` es APP_USR-8499883828799661-062409-bf057c51fc05f87eba5608328f869879-776566693, entonces tu `USER_ID` es 776566693. El `SPONSOR_ID` no puede ser igual al `USER_ID`.
Sucursal (Store)	Es una tienda física en la que tus clientes pueden adquirir tus productos o servicios. Puedes tener varias sucursales en una misma cuenta.
Caja (POS)	Es un punto de venta que existe en una sucursal o tienda física. Cada caja tendrá vinculado un código QR unívoco.
Orden	Es el pedido realizado por tu cliente. Contiene un listado de productos con su monto asociado.

Lee Credenciales para obtener más información..

Requisitos previos

Ten en cuenta estos aspectos antes de empezar:

1. Accede a una cuenta

Para poder comenzar la integración, es necesario contar con una cuenta de Mercado Pago o Mercado Libre.

Puedes Ingresar a una cuenta que ya exista o Crear una cuenta nueva.

2. Crea una aplicación

Necesitarás crear una aplicación por cada solución para tener todo organizado y llevar un control que te facilite la gestión. Crea una aplicación para obtener credenciales y configurar notificaciones webhooks.

Es fácil, te contamos cómo hacerlo:

Ingresa a Tus integraciones.
Elige “Nueva aplicación” o “Crear tu primera aplicación”.
Ponle un nombre con el que puedas identificarla más adelante.
Acepta nuestros Términos y Condiciones. ¡Y listo!

Nota

Si vas a operar en nombre de otros, puedes trabajar con las credenciales de ellos de una forma más fácil y segura por Marketplace.

3. Generar usuarios de prueba

Para comenzar la integración es necesario que tengas como mínimo dos usuarios: un comprador y un vendedor.

Ejecuta el siguiente comando para generar un usuario de prueba:

curl -X POST \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://api.mercadopago.com/users/test_user"
-d '{"site_id":"MLA"}'

Nota

Las credenciales que utilices deben ser las productivas de la cuenta con la cual vayas a operar.

Respuesta:

{
    "id": 123456,
    "nickname": "TT123456",
    "password": "qatest123456",
    "site_status": "active",
    "email": "test_user_123456@testuser.com"
}

IMPORTANTE

Puedes generar hasta 10 cuentas de usuarios de prueba en simultáneo. Por eso, te recomendamos guardar el email y password de cada uno.

Los usuarios de prueba caducan luego de 60 días sin actividad en Mercado Pago.

Para hacer pagos de prueba te recomendamos usar montos bajos.

Tanto el comprador como el vendedor deben ser usuarios de prueba.

Usa tarjetas de pruebas, ya que no es posible retirar el dinero.

Una vez creados los usuarios de pruebas, ya puedes comenzar con la integración y crear las sucursales y cajas.

Próximos pasos

REQUERIDO

Sucursales y Cajas

Para realizar la integración, primero debes configurar tus sucursales y cajas.