Crear configuración - Configuración de la integración - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos

Crear configuración

Para configurar la integración con la solución de Split de pagos, deberás crear tu aplicación, solicitar permisos a tus usuarios y obtener las credenciales. Continúa leyendo para crear la configuración necesaria.

Importante
Ten en cuenta que la solución de Split de pagos sólo se puede integrar con Checkout Pro , Checkout API y Checkout Bricks , y no está disponible para otros productos.

Crear aplicación

Crea tu aplicación para integrar con la solución de Split de pagos siguiendo los pasos a continuación.

Importante
Durante la creación de tu aplicación, es posible que sea necesario reautenticar tu identidad. Si ya has completado la verificación, se solicitará la reautenticación. En caso contrario, serás redirigido para enviar los documentos necesarios. Este paso adicional es esencial para proteger tu cuenta y garantizar la conformidad de las operaciones. Puedes consultar la documentación sobre el Panel del desarrollador si tienes alguna pregunta sobre cómo utilizarlo.
  1. Accede a Tus integraciones. Una vez allí, haz clic en el botón Crear aplicación, ubicado en la esquina superior derecha.
  2. Ingresa un nombre para identificar tu aplicación (tienes un límite de 50 caracteres).
  3. Elige la solución de Pagos online.
  4. A la hora de elegir el producto a integrar, puedes elegir “Checkout Pro” o “Checkout API” .
  5. Elige el modelo de integración Marketplace.
  6. Una vez que hayas completado la información solicitada, haz clic en Crear aplicación y ¡listo!

Configurar Redirect URL

En esta etapa, es necesario configurar la Redirect URL para que los vendedores autoricen al marketplace a realizar ventas.

Después de crear la aplicación, es necesario dirigirse a la pantalla de edición para completar el campo de Redirect URL (en las solicitudes de OAuth se muestra como redirect_uri), el cual debe contener la URL del sitio del marketplace a donde se enviará el token del vendedor al completar el proceso de vinculación.

Redirect URL

Solicitar permiso a usuarios

Para gestionar ventas en nombre de otro usuario, debes solicitar permiso. Para esto, es necesario implementar el flujo de autorización utilizando OAuth, tal como indicamos en los pasos a continuación:

  1. Redirige a tus usuarios a la siguiente URL para autorizar la gestión de ventas:
ValorDescripción
<APP_ID>Valor obtenido durante la creación de la aplicación.
<REDIRECT_URI>Valor ingresado en el campo Redirect Uri durante la configuración de la Redirect URL.

curl

https://auth.mercadopago.com.co/authorization?client_id=<APP_ID>&response_type=code&platform_id=mp&redirect_uri=<REDIRECT_URI>
  1. Una vez que los usuarios autoricen la gestión de ventas, recibirás un código de autorización en la URL que especificaste en el paso anterior. Este código estará en el parámetro code de la siguiente manera:

curl

http://<REDIRECT_URI>?code=AUTHORIZATION_CODE
Nota
El AUTHORIZATION_CODE tiene una validez de 10 minutos y será utilizado para crear las credenciales necesarias.

Obtener credenciales

Utiliza el código de autorización obtenido en el paso anterior para adquirir las credenciales del usuario mediante la API de OAuth, lo que te permitirá gestionar sus ventas.

ParámetroDescripción
<CLIENT_ID>Valor de APP_ID obtenido en los detalles de tu aplicación.
<CLIENT_SECRET>Tu SECRET_KEY, también disponible en los detalles de tu aplicación.
<AUTHORIZATION_CODE>Código de autorización obtenido al redirigir al usuario de vuelta a tu sitio.
<REDIRECT_URI>Debe ser la misma Redirect URI configurada en tu aplicación.
<STATE>Reemplaza el valor "RANDOM_ID" con un identificador que sea único para cada intento y que no incluya información confidencial para que puedas identificar de quién es el código recibido.

curl

curl -X POST \
     -H 'accept: application/json' \
     -H 'content-type: application/x-www-form-urlencoded' \
     'https://api.mercadopago.com/oauth/token' \
     -d 'client_id=<CLIENT_ID>' \
     -d 'client_secret=<CLIENT_SECRET>' \
     -d 'grant_type=authorization_code' \
     -d 'code=<AUTHORIZATION_CODE>' \
     -d 'redirect_uri=<REDIRECT_URI>' \
     -d 'state=<RANDOM_ID>'

Respuesta

json

{
    "access_token": "SELLER_PAYER_TOKEN",
    "public_key": "PUBLIC_KEY",
    "refresh_token": "TG-XXXXXXXXX-XXXXX",
    "live_mode": true,
    "user_id": "COLLECTOR_ID DE PAGO",
    "token_type": "bearer",
    "expires_in": 15552000,
    "scope": "offline_access payments write"
}

La respuesta incluye:

  • access_token y public_key del vendedor vinculado.
  • refresh_token, que debes utilizar para renovar periódicamente las vinculaciones.
  • user_id, igual al collector_id que se utiliza para capturar pagos.
Importante
Estas credenciales tienen una validez de 6 meses. En caso de no renovarlas antes de ese período, perderán vigencia y será necesario repetir el proceso de vinculación para autorizar nuevamente al vendedor. Para saber cómo renovar estas credenciales, consulta el paso a paso en la documentación de Renovación.