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.

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

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 Transparente" .
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!

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.

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:

https://auth.mercadopago.com.br/authorization?client_id=<APP_ID>&response_type=code&platform_id=mp&redirect_uri=<REDIRECT_URI>

2. 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:

http://<REDIRECT_URI>?code=AUTHORIZATION_CODE

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.

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>'

{
    "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.