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.
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.
- Siga as etapas descritas na documentação OAuth para obter cada
access_token
epublic_key
. Estas informaçÕes serão necessárias durante o processo de integração do checkout ao marketplace. - Escolha o tipo de checkout (Checkout Pro o Checkout Transparente) e siga o fluxo de integração.
- Na integração do checkout, utilize a
public_key
e oaccess_token
do vendedor (obtidos na etapa 1) no backend ou no header da requisição. - 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.