MercadoPago - Documentation

A integração MercadoPago usa o fluxo OAuth 2.0 com PKCE (Proof Key for Code Exchange). O processo é iniciado pelo painel da Velan e, após a autorização, os tokens são armazenados automaticamente.

Só é permitida uma integração MercadoPago ativa por empresa.

Passo a passo

Acesse Integrações e clique em INTEGRAR

No painel da Velan, acesse Integrações no menu lateral e localize o card do Mercado Pago. Clique em INTEGRAR.

Step 01 — Tela de Integrações com card Mercado Pago

Clique em CONECTAR

Você será direcionado para a página de detalhes da integração. Clique em CONECTAR para iniciar o fluxo OAuth.

Step 02 — Botão CONECTAR na página de detalhes

Selecione o país Brasil

Você será redirecionado para o Mercado Pago. Na tela de seleção de país, escolha Brasil.

Step 03 — Seleção de país no Mercado Pago

Confirme o país selecionado

Com Brasil selecionado, clique em Confirmar para prosseguir.

Autorize a integração

Revise as permissões que serão concedidas à Velan e clique em Autorizar.As permissões solicitadas são:

Leitura — acesso a dados do perfil e movimentações
Acesso Offline — manutenção do acesso até você cancelar a autorização
Write — criação de cobranças e links de pagamento

Step 05 — Tela de autorização de permissões no Mercado Pago

Retorno para a Velan

Após a autorização, o Mercado Pago redireciona automaticamente para a Velan.

Sucesso
Falha

Sua conta foi vinculada com sucesso. Clique em Hora de começar a faturar! para voltar ao painel.

Step 06 — Mercado Pago conectado com sucesso

Integração ativa

Com a conexão realizada, o card do Mercado Pago exibirá o status Ativo e o botão GERENCIAR estará disponível.

Step 07 — Card Mercado Pago ativo com botão GERENCIAR

Fluxo OAuth (referência técnica)

A Velan inicia o fluxo com PKCE (S256) para o endpoint de autorização do Mercado Pago:

https://auth.mercadopago.com/authorization?
  client_id=...&
  response_type=code&
  platform_id=mp&
  state={company_code}&
  redirect_uri=...&
  code_challenge={challenge}&
  code_challenge_method=S256&
  country_id=MLB

Após a autorização, o Mercado Pago redireciona para o callback da Velan, que troca o code pelos tokens e ativa a integração automaticamente.

Resultado	Redirecionamento
Sucesso	`/dashboard/integrations/mercado-pago-success`
Falha	`/dashboard/integrations/mercado-pago-fail`

Integração de co-produtor (parceiro)

Esta modalidade não está disponível para autoatendimento. Para habilitar a integração de co-produtor, entre em contato com o suporte da Velan.

Parceiros com acesso à empresa podem conectar sua própria conta MercadoPago para habilitar split de pagamento. O fluxo é iniciado pelo painel na seção de membros da empresa — o parceiro autoriza sua conta MP e a Velan passa a usá-la como receiver nas transações de split.

​Passo a passo

​Fluxo OAuth (referência técnica)

​Integração de co-produtor (parceiro)

Passo a passo

Fluxo OAuth (referência técnica)

Integração de co-produtor (parceiro)