My Belvo Portal

O My Belvo Portal (MBP) permite que os usuários gerenciem o consentimento que deram anteriormente a aplicativos (usando o produto OFDA da Belvo) para acessar seus dados na Rede de Open Finance.

Confirmar Identidade

Antes que os usuários possam acessar suas informações de consentimento, eles precisarão confirmar sua identidade autenticando-se com uma instituição bancária com a qual possuem uma conta.

Entrar

Na tela de Entrar, o usuário precisa fornecer seu CPF (Pessoas Físicas) ou a combinação de CNPJ e CPF (Empresas).

Seleção de Instituição

Na tela de Seleção de Instituição, o usuário seleciona qual instituição deseja usar para autenticar-se.

Revisar Solicitação de Consentimento de Autenticação

Na tela de Consentimento de autenticação, o usuário pode revisar quais dados serão usados para autenticar (Conferir resumo do consentimento) assim como por quanto tempo o consentimento será válido (Prazo de compartilhamento). Por padrão, isso é definido para um dia e não pode ser alterado pelo usuário.

Redirecionamento e Confirmação

O usuário é então redirecionado para sua instituição e, uma vez que conceda seu consentimento na instituição, é redirecionado de volta para o widget. Agora eles podem acessar o My Belvo Portal clicando em Acessar Meu Portal Belvo.

Verificando Consentimentos

Uma vez no MBP, o usuário pode verificar seus consentimentos de Open Finance clicando em Meus compartilhamentos, selecionando o consentimento e, em seguida, visualizando os detalhes do consentimento.

Opções de Hospedagem MBP

Em sua aplicação, você pode direcionar seus usuários para gerenciar seus consentimentos de duas maneiras:

• Usando a instância universal do MBP da Belvo. (Recomendado)
• Iniciando uma instância do MBP que exibirá apenas os consentimentos que seus usuários deram à sua aplicação.

MBP no Site da Belvo

No site da Belvo, hospedamos uma instância universal do MBP que qualquer usuário pode usar para gerenciar seus consentimentos. Esta instância consolida todos os consentimentos que eles concederam usando o produto OFDA da Belvo.

Em seu aplicativo, você pode direcionar seus usuários para a instância universal do MBP da Belvo usando este URL: https://meuportal.belvo.com/.

Se você deseja que seus usuários vejam apenas os consentimentos que concederam ao seu aplicativo, veja MBP customized consent view.

Visualização de consentimento personalizada do MBP

Você pode personalizar o MBP para exibir apenas os consentimentos que seu usuário concedeu à sua aplicação, facilitando para eles o gerenciamento de seus consentimentos.

Para criar um MBP personalizado que exiba apenas os consentimentos concedidos à sua aplicação:

1. Crie um access_token (Para indivíduos, você precisará fornecer os detalhes do CPF. Para empresas, são necessários os detalhes do CPF e CNPJ).

curl -X POST \
  https://sandbox.belvo.com/api/token/ \
  -H 'Content-Type: application/json' \
  -H 'Host: sandbox.belvo.com' \
  -d 'Veja o exemplo de payload abaixo'

{
  "id": "{{secretId}}",
  "password": "{{secretPassword}}",
  "scopes": "read_consents,write_consents,write_consent_callback",
  "widget": {
    "openfinance_feature": "consent_management",
    "consent": {
      "terms_and_conditions_url": "url_to_your_terms_and_conditions",
      "permissions": ["REGISTER", "ACCOUNTS", "CREDIT_CARDS", "CREDIT_OPERATIONS"],
      "identification_info": [
        {
          "type": "CPF",
          "number": "individual_cpf",
          "name": "individual_full_name"
        }
      ] 
    }
  }
}

2. Adicione o access_token à URL do MBP: https://meuportal.belvo.com/?access_token={accessToken}.
3. Forneça ao seu usuário a URL gerada.

❇️ Feito! Assim que seu usuário fizer login no MBP, ele poderá gerenciar os consentimentos que concedeu à sua aplicação.

Renovação de consentimento com o MBP

O MBP também pode ser usado para renovar um consentimento expirado. A Belvo enviará um webhook quando o consentimento de um dos seus usuários expirar. Um exemplo de payload de webhook é o seguinte:

{
  "webhook_id": "e6f08793f967445fb74ce16beae665bc",
  "webhook_type": "CONSENT",
  "webhook_code": "consent_expired",
  "link_id": "3d3364b7-0175-483d-a58b-b471f251e533",
  "external_id": null,
  "data": {
    "consent_id": "29a54e55-21f0-4d02-8e34-797ab7d43940",
    "action": "renew",
    "institution": "ofmockbank_br_retail",
    "institution_display_name": "OF Mockbank",
    "institution_icon_logo": "https://logo.com"
  }
}

Após receber o webhook, você pode configurar o MBP para o modo 'renovar consentimento' criando uma URL com as seguintes informações:

https://meuportal.belvo.com/
 ?access_token={accessToken}
 &link_id={webhook_link_id}
 &consent_id={webhook_consent_id}
 &institution={webhook_institution}
 &institution_display_name={the_display_name_url_encoded}
 &institution_icon_logo={url_to_icon}
 &action=renew

Direcionar seus usuários para esta URL os guiará automaticamente pelo processo de renovação de consentimento.