Skip to main content
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

1

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
2

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
3

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
4

Confirme o país selecionado

Com Brasil selecionado, clique em Confirmar para prosseguir.
Step 04 — Confirmar país Brasil
5

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
6

Retorno para a Velan

Após a autorização, o Mercado Pago redireciona automaticamente para a Velan.
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
7

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