Inicio
Documentação
Recursos
Parcerias
Comunidade

Parcerias

Conheça nosso programa para agências ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratá-los.

Comunidade

Fique por dentro das últimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Integrar o checkout em Split de Pagamentos - Configuração da integração - Mercado Pago Developers

Busca inteligente powered by OpenAI 

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 API: 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 API ) 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 API , preencha o parâmetro application_fee com o valor a ser cobrado para cada pagamento criado na API /payments.

Exemplo

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": "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. Tenha em mente que a solução Split de pagamentos permite a realização de pagamentos com saldo disponível entre contas Mercado Pago. Não são permitidas transferências de instituições financeiras externas.

Importante
Em caso de reembolso, o valor devido ao cliente final será dividido e subtraído da conta do vendedor e da conta do Marketplace, sendo proporcional para as partes envolvidas. Além disso, em modelos 1:1, o Marketplace não poderá realizar o reembolso total se o vendedor não tiver dinheiro na conta. Nesse caso, cabe à conta do Marketplace reembolsar o equivalente à sua parte e decidir se devolverá o restante, que é responsabilidade do vendedor, por outro meio.