Skip to main content
A integração Bling usa OAuth 2.0 Authorization Code. As credenciais (client_id e client_secret) são configuradas no painel da Velan antes de iniciar o fluxo.

Passo a passo

1. Crie um app no portal do Bling e copie client_id e client_secret
2. No painel da Velan, acesse Integrações e clique em INTEGRAR no card do Bling
3. Informe o client_id e client_secret no modal de configuração
4. Clique em Autorizar — você é redirecionado para o Bling
5. Autorize o acesso no Bling
6. O Bling retorna para a Velan, que salva os tokens e ativa a integração

1. Criar app no Bling

Acesse o portal de desenvolvedores do Bling, crie um aplicativo e configure o Redirect URI para:
https://api.velan.app/v1/integrations/bling/callback
Copie o client_id e client_secret gerados.

2. Fluxo OAuth (referência técnica)

A Velan redireciona o usuário para:
https://www.bling.com.br/Api/v3/oauth/authorize?
  response_type=code&
  client_id={client_id}&
  state={company_code}&
  redirect_uri=https://api.velan.app/v1/integrations/bling/callback
Após autorização, o Bling redireciona para o callback da Velan, que troca o code pelos tokens e os salva na integração. Em caso de sucesso, o usuário é redirecionado para o painel em:
/dashboard/integrations/bling-success
Em caso de falha:
/dashboard/integrations/bling-fail

Reautorização

Se o access_token expirar, acesse o painel, remova a integração Bling existente e refaça o fluxo a partir do passo 2.