Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Create configuration - Integration configuration - Mercado Pago Developers

Intelligent search powered by OpenAI 

Create configuration

To configure the integration with the Split payments solution, you will need to create your application, request permissions from your users, and obtain the credentials. Keep reading to create the required configuration.

Important
Please note that the Split payments solution can only be integrated with Checkout Pro , Checkout API and Checkout Bricks , and is not available for use with other products.

Create application

Create your application to integrate with the Split payments solution by following the steps below.

Important
During the creation of your application, it may be necessary to reauthenticate your identity. If you have already completed the verification, reauthentication will be requested. Otherwise, you will be redirected to submit the necessary documents. This additional step is essential to protect your account and ensure compliance with operations. You can refer to the Developer dashboard documentation if you have any questions on how to use it.
  1. Access Your Integrations. Once there, click on the Create application button, located in the upper right corner.
  2. Enter a name to identify your application (you have a limit of 50 characters).
  3. Choose the Online Payments solution.
  4. When choosing the product to integrate, you can select "Checkout Pro" or "Checkout API".
  5. Choose the Marketplace integration model.
  6. Once you have completed the requested information, click on Create application and you're done!

Configure the Redirect URL

In this step, it is necessary to configure the Redirect URL so that sellers can authorize the marketplace to carry out sales.

After creating the application, it is necessary to go to the editing screen to fill in the Redirect URL field (in OAuth requests, it is displayed as redirect_uri), which must contain the URL of the marketplace site where the seller's token will be sent upon completing the linking process.

Redirect URL

Request permission from users

To request permission from your users to manage sales on their behalf, it is necessary to implement the authorization flow using OAuth. Follow the steps below:

  1. Redirect your users to the following URL to authorize sales management:
ValueDescription
<APP_ID>Value obtained during application creation.
<REDIRECT_URI>Value entered in the Redirect URI field during Redirect URL configuration.

curl

https://auth.mercadopago.com.mx/authorization?client_id=<APP_ID>&response_type=code&platform_id=mp&redirect_uri=<REDIRECT_URI>
  1. Once users authorize sales management, you will receive an authorization code in the URL you specified in the previous step. This code will be in the code parameter as follows:

curl

http://<REDIRECT_URI>?code=AUTHORIZATION_CODE
Nota
The AUTHORIZATION_CODE is valid for 10 minutes and will be used to create the necessary credentials.

Obtain credentials

Use the authorization code obtained in the previous step to acquire user credentials through the OAuth API, enabling you to manage their sales.

ParameterDescription
<CLIENT_ID>Value of APP_ID obtained in the details of your application.
<CLIENT_SECRET>Your SECRET_KEY, also available in the details of your application.
<AUTHORIZATION_CODE>Authorization code obtained when redirecting the user back to your site.
<REDIRECT_URI>Should be the same Redirect URI configured in your application.
<STATE>Replace the "RANDOM_ID" value with an identifier that is unique for each attempt and does not include sensitive information so that you can identify who the received code is from.

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

Response

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"
}

The response includes:

  • access_token and public_key of the linked seller.
  • refresh_token, which you should use to periodically renew the linkages.
  • user_id, equal to the collector_id used to capture payments.
Important
These credentials are valid for 6 months. If not renewed before that period, they will expire, and it will be necessary to repeat the linking process to authorize the seller again. To learn how to renew these credentials, consult the step-by-step in the Renewal documentation.