Integrate checkout in Split payments (marketplace)
If you choose to sell through a marketplace, it is possible to integrate two types of Mercado Pago checkout to process payments.
- Checkout Pro: In this checkout model, the buyer is directed to a Mercado Pago page to complete the payment.
- Checkout API: This checkout model allows the buyer to make the payment within the marketplace environment.
Both checkouts automatically split the amounts between the seller and the marketplace through the split payments.
To perform the integration, you will need to follow the usual integration flow of the chosen checkout, necessarily using an access token for each seller, obtained through OAuth. Below we list the steps required to integrate a checkout with the marketplace.
- Follow the steps described in the OAuth documentation to get each
access_token
. This information will be needed during the checkout integration process into the marketplace. - Choose the type of checkout you want (Checkout Pro or Checkout API) and follow the entire onboarding flow.
- In the checkout integration, use the
public_key
of your integrator account in the frontend and insert the seller'saccess_token
(obtained in step 1) in the backend or in the request header. - To determine the marketplace commission percentage:
- If it's Checkout Pro, fill the
marketplace_fee
parameter with the amount to be charged for each payment preference created in the /checkout/preferences API.
Example
json
{
"items": [
{
"id": "item-ID-1234",
"title": "Meu produto",
"currency_id": "BRL",
"quantity": 1,
"unit_price": 75.76
}
],
"marketplace_fee": 10
}
- If it's Checkout API , fill the
application_fee
parameter with the amount to be charged for each payment created in the /payments API.
Example
curl
curl --location 'https://api.mercadopago.com/v1/payments' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer {{oauth_access_token}}' \
--data-raw '{
"description": "Test payment 3",
"installments": 1,
"token": "{{card_token}}",
"payer": {
"email": "{{payer_email}}"
},
"payment_method_id": "master",
"transaction_amount": 25,
"application_fee": 10
}'
Upon completing these steps, the checkout will have been integrated into the marketplace and will be ready to process payments. Keep in mind that the Split payments solution allows for payments using available balance between Mercado Pago accounts. Transfers from external financial institutions are not permitted.