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

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

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