Integrar o checkout em Split de Pagamentos - Configuração da integração - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Integrar o checkout em Split de pagamentos (marketplace)

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 pagamentos, sem a necessidade de qualquer ação por parte do vendedor.

Importante
A comissão do Mercado Pago é descontada do valor recebido pelo vendedor. Ou seja, primeiro, a comissão do Mercado Pago é descontada e, em seguida, a comissão do Marketplace é descontada sobre o valor restante.

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. Esta informação será necessária durante o processo de integração do checkout ao marketplace.
  2. Escolha o tipo de checkout (Checkout Pro ou Checkout Transparente) e siga o fluxo de integração.
  3. Na integração do checkout, utilize a public_key da sua conta de integrador no frontend e insira o access_token do vendedor (obtido 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.

Exemplo

json

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

Exemplo

json

    {
    "description": "API TRANSPARENTE MARKETPLACE",
    "installments": 1,
    "token": "{{card_token}}",
    "payer": {
        "id": "{{payer_id}}"
    },
    "marketplace": "{{marketplace_id}}",
    "payment_method_id": "master",
    "application_fee": 2,
    "transaction_amount": 10
    }

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