Pular para o conteúdo
Última atualização

Pré-requisitos e Autenticação

Gerar Chaves de API

Para usar nossa API, você precisará gerar algumas chaves de API para autenticar todas as suas solicitações.

Para gerar suas chaves de API:

  1. Faça login no seu Dashboard Belvo.
  2. Escolha o ambiente para o qual você deseja criar chaves de API (Sandbox ou Production). Se você está começando a usar a API da Belvo, recomendamos usar o ambiente Sandbox.
  3. Vá para Developers -> API Keys.
  4. Clique em Generate API Keys, o que gerará automaticamente suas chaves de API.
  5. No pop-up, copie e salve com segurança os valores para Secret ID e Secret Password.
    Nota: No pop-up, você também tem a opção de fazer um fork da coleção de API da Belvo. Para mais informações sobre como usar o Postman e a coleção da Belvo, consulte nosso guia de Introdução em 10 minutos.

✳️ Feito! Você acabou de gerar suas chaves de API! Mas antes de começar a fazer chamadas de API, você só precisa configurar um webhook onde podemos enviar eventos.

Adicionar uma URL de webhook

Apenas testando?

Se você está apenas começando sua integração e não tem certeza de como obter uma URL para um webhook, pode usar um serviço como o Pipedream. Confira nosso Começando em cerca de 10 minutos para ver como é feito!

Para configurar um novo webhook:

  1. Faça login no seu Dashboard Belvo.
  2. Escolha o ambiente para o qual você deseja receber eventos de webhook (Sandbox ou Produção).
  3. Vá para Desenvolvedores -> Webhooks.
  4. Clique em +Novo webhook.
  5. Preencha o formulário Novo webhook com as informações necessárias.
    1. URL: a URL para receber as notificações do webhook.
    2. Autorização: um token bearer opcional para usar se sua URL estiver protegida.
  6. Clique em Criar webhook.

✳️ Feito! Você agora criou um webhook e pode começar a criar links e receber eventos!

Lista de Permissão de Endereços IP da Belvo

A Belvo enviará eventos para o seu URL de webhook a partir dos endereços IP listados abaixo. Sua equipe de segurança pode querer adicionar esses endereços à lista de endereços IP dos quais eles permitem eventos (caso contrário, seu sistema pode bloquear eventos de chegarem ao seu sistema).

  • 3.130.254.46
  • 18.220.61.186
  • 18.223.45.212