Marketplace é um site/plataforma de e-commerce que conecta vendedores e compradores em um único ambiente de venda, permitindo a venda de produtos e/ou serviços online com maior abrangência e possibilidade de conversão.

Além da estrutura necessária para realizar vendas, alguns marketplaces cuidam da disposição dos produtos, métodos de pagamento e envio, otimizando o processo de venda e facilitando o gerenciamento do negócio.

Caso escolha vender através de um marketplace, é possível integrar dois tipos de checkout do Mercado Pago para processar os pagamentos realizados.

• Checkout Pro: Neste modelo de checkout, o comprador é direcionado para uma página do Mercado Pago para concluir o pagamento.
• Checkout Transparente: Este modelo de checkout permite ao comprador realizar o pagamento dentro do ambiente do marketplace.

Ambos os checkouts realizam automaticamente a divisão dos valores entre o vendedor e o marketplace por meio do split de pagamento, sem a necessidade de qualquer ação por parte do vendedor.

Para realizar a integração você precisará seguir o fluxo de integração usual do checkout escolhido utilizando um access token para cada vendedor, obtido através de OAuth. Abaixo, listamos as etapas necessárias para integrar um checkout ao marketplace.

1. Siga as etapas descritas na documentação OAuth para obter cada access_token e public_key. Estas informaçÕes serão necessárias durante o processo de integração do checkout ao marketplace.
2. Escolha o tipo de checkout (Checkout Pro o Checkout Transparente) e siga o fluxo de integração.
3. Na integração do checkout, utilize a public_key e o access_token do vendedor (obtidos na etapa 1) no backend ou no header da requisição.
4. Para determinar a porcentagem de comissão do marketplace:

• Se o checkout for Pro, preencha o parâmetro marketplace_fee com o valor a ser cobrado para cada preferência de pagamento criada na API /checkout/preferences.

    {
    "items": [
        {
            "id": "item-ID-1234",
            "title": "Meu produto",
            "currency_id": "BRL",
            "quantity": 1,
            "unit_price": 75.76
        }
    ],
    "marketplace_fee": 10
    }

• Se o checkout for Transparente, preencha o parâmetro application_fee com o valor a ser cobrado para cada pagamento criado na API /payments.

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": "Pagamento de teste 3",
    "installments": 1,
    "token": "{{card_token}}",
    "payer": {
        "email": "{{payer_email}}"
    },
    "payment_method_id": "master",
    "transaction_amount": 25,
    "application_fee": 10
}'

Ao finalizar essas etapas, a integração do checkout com o marketplace estará concluída e pronta para processar os pagamentos.