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.

Como integrar Checkout em marketplace - Checkout Transparente - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

Como integrar o checkout em marketplace

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.

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

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

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.