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