Lista de Verificação de Integração (OFDA)

Para ajudá-lo durante o seu processo de integração OFDA, criamos uma lista de verificação para você seguir 😉. Certifique-se de abordar todos os itens antes de solicitar acesso ao ambiente de Produção.

Implementar o widget

Enquanto você integra o widget, certifique-se de que:

• Seus usuários primeiro registrem uma conta com seu aplicativo antes de solicitar que eles conectem suas contas com a Belvo.
• Você está usando o parâmetro external_id para fornecer seu próprio ID único para um link (ou grupo de links) em seu sistema. Nota: Este parâmetro também é pesquisável dentro do sistema da Belvo.
• Se estiver usando links únicos, você usa o parâmetro fetch_resources para receber assincronamente dados históricos sobre seu usuário.
• Você pode gerar um access_token tanto para indivíduos quanto para empresas.
• Você implementou corretamente suas URLs de callback.
• Você pode lidar com eventos de Sucesso, Saída, Erro e Aviso do Hosted Widget.

Tratamento de Erros

Certifique-se de que sua integração pode lidar e registrar o request_id de:

• Erros 400 e 401
• Erros 500
• Erros de timeout

Pedimos que você registre o request_id caso precise entrar em contato com nossa equipe de suporte. Com este ID, podemos acelerar o processo de resolução de problemas e encontrar uma solução para você.

Manipulação de Requisições

Sua integração pode lidar com:

• Respostas de Sucesso 200, 201 e 202
• Respostas de Sucesso 204 (quando você exclui alguns dados)
• Paginação

Além disso, certifique-se de que com respostas bem-sucedidas, você armazene:

• O identificador único para o objeto (por exemplo, o transaction.id)
  Isso permitirá que você evite ter objetos duplicados (como transações) no seu banco de dados.

Webhooks

Seja você um usuário de links únicos ou recorrentes, certifique-se de:

• <a href="../../developer_resources/resources-webhooks-aggregation target="_blank" rel="noopener noreferrer">Definir uma URL de webhook no dashboard para que você possa receber eventos de webhook. Lembre-se de que você precisará definir URLs de webhook diferentes dependendo do ambiente em que está trabalhando.
• Se estiver usando links recorrentes, que você configurou sua taxa de atualização de acordo com suas necessidades (diária, semanal ou mensal) (entre em contato com nossa equipe de vendas).
• Enviar apenas solicitações GET após receber um evento de webhook.
• Responder dentro de cinco segundos após receber um webhook com um 200 OK.
• Colocar na lista de permissões os seguintes endereços IP:

Você pode receber eventos de webhook dos seguintes endereços IP:

• 3.130.254.46
• 18.220.61.186
• 18.223.45.212

Criação e gerenciamento de links

Sua integração:

• Possui um mecanismo para evitar que links duplicados sejam criados?
• Monitora os status de link invalid e token_required e, se necessário, solicita que seus usuários atualizem suas credenciais?
• Está familiarizado com os limites de rede do Open finance Brasil.

Meu Portal Belvo

Você:

• Implementou um link de fácil acesso para o Meu Portal Belvo?
• Implementou um mecanismo para lidar com eventos de webhook de Consentimento consent_expired?

Alterações que não causam interrupção

Se fizermos as seguintes alterações que não causam interrupção na nossa API, você tem certeza de que isso não afetará sua integração?

• Novos campos ou uma ordem diferente no corpo da resposta.
• Alterar o número de caracteres de uma string.
• Retornar timestamps yyyy-MM-ddTHH:mm:ss.SSSZ, onde S são microssegundos (de 3 a 6 dígitos) e Z é ou +00:00 ou Z.
• Adicionar novos endpoints.

URL e Chaves de API

Quando você estiver mudando para Produção, certifique-se de que:

• Você está chamando a versão de produção da API da Belvo (https://api.belvo.com).
• Você está usando suas Chaves de API de Produção da Belvo.
• Você está armazenando suas chaves de API de forma segura.

Inscreva-se para atualizações

Certifique-se de que você se inscreveu nos seguintes serviços para estar atualizado sobre o status da nossa API e das instituições:

• Status da API Belvo
• Status da instituição (consulte nosso guia dedicado)