Bling - Documentation

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

Crie um app no portal do Bling e copie client_id e client_secret
No painel da Velan, acesse Integrações e clique em INTEGRAR no card do Bling
Informe o client_id e client_secret no modal de configuração
Clique em Autorizar — você é redirecionado para o Bling
Autorize o acesso no Bling
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.

​Passo a passo

​1. Criar app no Bling

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

​Reautorização

Passo a passo

1. Criar app no Bling

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

Reautorização