# Gerar um token de acesso para o widget

Gerar um token de acesso para nosso Widget Hospedado.

Endpoint: POST /api/token/
Version: 1.223.0
Security: basicAuth

## Request fields (application/json):

  - `body` (object, required) — one of:
    - OFDA 🇧🇷 Brazil Access Token:
      - `id` (string, required)
        Seu Belvo secretId.
      - `password` (string, required)
        Sua Belvo secretPassword.
      - `scopes` (string, required)
        O parâmetro scopes contém uma lista de permissões que permitem criar um link para o usuário. Este é um parâmetro obrigatório e deve ser enviado exatamente como mostrado.
        Example: "read_institutions,write_links,read_consents,write_consents,write_consent_callback,delete_consents"
      - `fetch_resources` (array, required)
        Uma matriz de recursos para os quais você gostaria de receber uma atualização histórica.

{% admonition type="warning" name="Aguarde os Webhooks Antes de Recuperar Dados" %}
  Após solicitar recursos usando fetch_resources, você deve aguardar o webhook de atualização histórica do Belvo antes de recuperar os dados. Fazer solicitações antes de receber o webhook (GET ou POST) retornará resultados vazios ou incompletos.
{% /admonition %}

Para OFDA Brasil, você pode selecionar os seguintes recursos:
  - ACCOUNTS
  - OWNERS
  - TRANSACTIONS
  - BILLS

Além disso, você pode optar pelos seguintes recursos específicos de Open Finance (entre em contato com seu representante, pois custos adicionais se aplicam):
  - INVESTMENTS
  - INVESTMENT_TRANSACTIONS
  - EXCHANGES

Para OFDA, você pode habilitar recursos de Enriquecimento para obter insights estendidos (entre em contato com seu representante, pois custos adicionais se aplicam):
  - INCOMES
  - RECURRING_EXPENSES
  - RISK_INSIGHTS

{% admonition type="info" name="Recursos de Enriquecimento Requerem Dados de Transações" %}
  Para calcular recursos de enriquecimento (INCOMES, RECURRING_EXPENSES, RISK_INSIGHTS), você também deve incluir ACCOUNTS e TRANSACTIONS na sua matriz fetch_resources. Sem esses recursos fundamentais, os cálculos de enriquecimento serão incompletos ou podem não ser gerados.
{% /admonition %}
        Enum: "ACCOUNTS", "TRANSACTIONS", "OWNERS", "BILLS", "INVESTMENTS", "INVESTMENT_TRANSACTIONS", "EXCHANGES", "INCOMES", "RECURRING_EXPENSES", "RISK_INSIGHTS"
      - `stale_in` (string, required)
        Indica por quanto tempo qualquer dado derivado do usuário deve ser armazenado no banco de dados da Belvo para o link (tanto único quanto recorrente). Por exemplo, se você enviar 90d, a Belvo removerá qualquer dado relacionado ao usuário de seu banco de dados após 90 dias. Para mais informações, confira a seção stale_in do nosso artigo sobre controles de retenção de dados.

> 📘 Informação
>
> A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in. A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in.

Por padrão, a Belvo armazena dados do usuário por 365 dias, a menos que o link seja deletado.
        Example: "42d"
      - `widget` (object, required)
        O objeto widget contém informações adicionais sobre como configurar o widget, incluindo personalização de marca, seus termos e condições, URLs de callback e informações sobre o usuário para o qual você deseja extrair dados.
      - `widget.openfinance_feature` (string, required)
        O parâmetro openfinance_feature indica que o usuário final passará pelo fluxo OFDA. Ele deve ser configurado como consent_link_creation.
        Example: "consent_link_creation"
      - `widget.callback_urls` (object, required)
        No objeto callback_urls, você deve adicionar links para onde seu usuário deve ser redirecionado nos seguintes casos:

- success (seu usuário conectou suas contas com sucesso)
- exit (seu usuário saiu do widget antes de completar o processo)
- event (ocorreu um erro durante o processo de conexão)

Para mais informações, confira a seção callback_urls no nosso guia do Hosted Widget (OFDA).

> 📘 Eventos de Callback
>
> A Belvo também enviará informações adicionais sobre o evento, dependendo do evento. Para mais informações, certifique-se de conferir a seção Handling callback events do guia do Hosted Widget (OFDA).
      - `widget.callback_urls.success` (string, required)
        A URL para a qual o usuário é redirecionado quando conecta sua conta com sucesso.
        Example: "your_deeplink_here://success"
      - `widget.callback_urls.exit` (string, required)
        A URL para a qual o usuário é redirecionado quando sai do processo antes de conectar sua conta.
        Example: "your_deeplink_here://exit"
      - `widget.callback_urls.event` (string, required)
        A URL para a qual o usuário é redirecionado quando encontra um erro ao conectar sua conta.
        Example: "your_deeplink_here://error"
      - `widget.branding` (object, required)
        No objeto branding, você deve adicionar seu:
- company_icon
- company_logo
- company_name
- company_terms_url

Você também pode, opcionalmente, adicionar uma cor de fundo personalizada para quando o widget abrir, assim como desativar a mensagem da Belvo sobre quantas contas foram conectadas.

Para mais informações sobre as opções de personalização e branding do widget, confira nosso guia dedicado.
      - `widget.branding.company_icon` (string, required)
        Você pode adicionar o ícone da sua empresa ao widget para alinhá-lo melhor com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (OFDA).
        Example: "https://mysite.com/icon.svg"
      - `widget.branding.company_logo` (string, required)
        Você pode adicionar o logotipo da sua empresa ao widget para alinhá-lo melhor com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (OFDA).
        Example: "https://mysite.com/logo.svg"
      - `widget.branding.company_name` (string, required)
        Você pode adicionar o nome da sua empresa para ser exibido quando o widget for iniciado pela primeira vez. Por padrão, será exibido apenas "Link your account". Quando você adiciona o nome da sua empresa, a mensagem seguirá o formato "[company_name] uses Belvo to connect your account". Para mais informações, consulte a seção company_name do nosso guia de Branding e personalização (OFDA).
        Example: "ACME"
      - `widget.branding.company_terms_url` (string, required)
        Você pode adicionar um link para sua política de privacidade (ou termos e condições) na tela inicial do widget que, quando clicado, redirecionará seus usuários para a página da web vinculada. Isso ajuda seus usuários a entenderem melhor qual é o seu caso de uso em relação aos dados que você está solicitando. Para mais informações, consulte a seção company_terms_url do nosso guia de Branding e personalização (OFDA).
        Example: "https://belvo.com/terms-service/"
      - `widget.branding.overlay_background_color` (string)
        Você pode adicionar uma cor de sobreposição personalizada para quando o widget carregar em seu aplicativo desktop. Para mais informações, consulte a seção overlay_background_color do nosso guia de Branding e personalização (OFDA).
        Example: "#F0F2F4"
      - `widget.branding.social_proof` (boolean)
        Você pode optar por ocultar a mensagem "Mais de 5 milhões de usuários já conectaram com segurança suas contas." que aparece quando seu usuário seleciona sua instituição no widget. Para mais informações, consulte a seção social_proof do nosso guia de Branding e personalização (OFDA).
        Example: true
      - `widget.branding.show_belvo_middle_logo` (boolean)
        Você pode optar por exibir o logotipo da Belvo entre o logotipo da sua empresa e o logotipo da instituição na tela inicial de conexão. Quando definido como true, o logotipo da Belvo será exibido. O padrão é false. Para mais informações, consulte a seção show_belvo_middle_logo do nosso guia de Personalização e Branding do Widget OFDA.
      - `widget.theme` (array)
        Você pode adicionar opcionalmente as cores da sua marca ao widget usando o parâmetro theme.

Para mais informações sobre onde essas cores aparecerão no widget, consulte a seção dedicada Adicionar cores personalizadas ao widget do nosso guia de Branding.
      - `widget.theme.css_key` (string, required)
        Nome da variável CSS. Valores possíveis incluem:
- --color-primary-base
- --nav-bar-title-color
- --nav-bar-icon-color
        Example: "--color-primary-base"
      - `widget.theme.value` (string, required)
        O código HEX para o css_key.
        Example: "#907AD6"
      - `widget.consent` (object, required)
        O objeto consent é exclusivo do widget OFDA e deve ser enviado.
      - `widget.consent.purpose` (string, required)
        No parâmetro purpose, você pode personalizar a mensagem que é exibida ao seu usuário sobre para qual caso de uso você está solicitando os dados dele. Para mais informações, confira a seção purpose no nosso guia do Hosted Widget (OFDA).
        Example: "Soluções financeiras personalizadas oferecidas por meio de recomendações sob medida, visando melhores ofertas de produtos financeiros e de crédito."
      - `widget.consent.terms_and_conditions_url` (string, required)
        No parâmetro terms_and_conditions_url, você deve fornecer um link para os termos e condições da sua empresa.
        Example: "https://www.your_terms_and_conditions.com"
      - `widget.consent.permissions` (array, required)
        O parâmetro permissions contém os recursos que você deseja extrair da Rede de Open Finance do Brasil para o usuário. Este valor deve ser definido como ["REGISTER", "ACCOUNTS", "CREDIT_CARDS", "CREDIT_OPERATIONS"].
        Enum: "REGISTER", "ACCOUNTS", "CREDIT_CARDS", "CREDIT_OPERATIONS"
      - `widget.consent.identification_info` (array, required)
        No array identification_info, você precisa fornecer as informações de identificação do usuário para o qual deseja recuperar informações. As informações fornecidas aqui devem corresponder às informações que a instituição regulada possui para o usuário (por exemplo, para empresas, o CPF e o nome devem ser de um usuário com acesso à conta empresarial).

- Para indivíduos, você só precisa fornecer o CPF e o nome.
- Para empresas, é necessário fornecer tanto o CPF quanto o CNPJ.

Para mais informações, consulte a seção identification_info do nosso guia Hosted Widget (OFDA).
      - `widget.consent.identification_info.type` (string, required)
        O tipo de identificador. Pode ser CPF ou CNPJ.
        Example: "CPF"
      - `widget.consent.identification_info.number` (string, required)
        O número de CPF ou CNPJ do indivíduo ou empresa associado à identificação.
        Example: 76109277673
      - `widget.consent.identification_info.name` (string, required)
        Nome do indivíduo ou empresa associado à identificação.
        Example: "Ralph Bragg"
      - `widget.consent.default_consent_duration_days` (number)
        Você pode pré-selecionar a duração do consentimento no menu suspenso. O parâmetro default_consent_duration_days aceita 366, 275, 183 ou 92 dias (correspondendo a 12, 9, 6 ou 3 meses). Se você fornecer qualquer outro valor, o menu suspenso será definido como "Indeterminado". Para mais informações, consulte a seção default_consent_duration_days do nosso guia de Personalização e Branding do Widget OFDA.
        Enum: 92, 183, 275, 366
    - Empregos 🇧🇷 Brazil Access Token:
      - `id` (string, required)
        Seu Belvo secretId.
      - `password` (string, required)
        Sua Belvo secretPassword.
      - `scopes` (string, required)
        O parâmetro scopes contém uma lista de permissões que permitem criar um link para o usuário. Este é um parâmetro obrigatório e deve ser enviado exatamente como mostrado.
        Example: "read_institutions,write_links"
      - `fetch_resources` (array, required)
        Uma matriz de recursos para os quais você gostaria de receber uma atualização histórica.

Para Empregos Brasil (INSS), você pode selecionar os seguintes recursos:
  - EMPLOYMENTS
  - OWNERS
        Enum: "EMPLOYMENTS", "OWNERS"
      - `stale_in` (string, required)
        Indica por quanto tempo qualquer dado derivado do usuário deve ser armazenado no banco de dados da Belvo para o link (tanto único quanto recorrente). Por exemplo, se você enviar 90d, a Belvo removerá qualquer dado relacionado ao usuário de seu banco de dados após 90 dias. Para mais informações, confira a seção stale_in do nosso artigo sobre controles de retenção de dados.

> 📘 Informação
>
> A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in. A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in.

Por padrão, a Belvo armazena dados do usuário por 365 dias, a menos que o link seja deletado.
        Example: "42d"
      - `credentials_storage` (string)
        Indica se as credenciais devem ou não ser armazenadas (e a duração para a qual as credenciais serão armazenadas).

- Para links recorrentes, isso é definido como store por padrão (e não pode ser alterado).
- Para links únicos, isso é definido como 365d por padrão.

Pode ser:
  - store para armazenar credenciais (até que o link seja excluído)
  - nostore para não armazenar credenciais
  - Qualquer valor entre 1d e 365d para indicar o número de dias que você deseja que as credenciais sejam armazenadas.

Para mais informações, confira a seção credentials_storage do nosso artigo sobre controles de retenção de dados.
        Example: "27d"
      - `widget` (object, required)
        O objeto widget contém informações adicionais sobre como configurar o widget, incluindo personalização de marca, seus termos e condições, URLs de callback e informações sobre o usuário para o qual você deseja extrair dados.
      - `widget.callback_urls` (object)
        > 📘 Apenas necessário para o Widget Hospedado.

No objeto callback_urls, você deve adicionar links para onde seu usuário deve ser redirecionado nos seguintes casos:

- success (seu usuário conectou suas contas com sucesso)
- exit (seu usuário saiu do widget antes de completar o processo)
- event (ocorreu um erro durante o processo de conexão)

Para mais informações, confira a seção callback_urls no nosso guia do Widget Hospedado (Multi-Region).

> 📘 Eventos de Callback
>
> A Belvo também enviará informações adicionais sobre o evento, dependendo do evento. Para mais informações, certifique-se de conferir a seção Handling callback events do guia do Widget Hospedado (Multi-Region).
      - `widget.callback_urls.success` (string, required)
        A URL para a qual o usuário é redirecionado quando conecta sua conta com sucesso.
        Example: "your_deeplink_here://success"
      - `widget.callback_urls.exit` (string, required)
        A URL para a qual o usuário é redirecionado quando sai do processo antes de conectar sua conta.
        Example: "your_deeplink_here://exit"
      - `widget.callback_urls.event` (string, required)
        A URL para a qual o usuário é redirecionado quando encontra um erro ao conectar sua conta.
        Example: "your_deeplink_here://error"
      - `widget.branding` (object, required)
        No objeto branding, você deve adicionar seu:
- company_icon
- company_logo
- company_name
- company_terms_url

Você também pode, opcionalmente, adicionar uma cor de fundo personalizada para quando o widget abrir, assim como desativar a mensagem da Belvo sobre quantas contas foram conectadas.

Para mais informações sobre as opções de personalização e branding do widget, confira nosso guia dedicado.
      - `widget.branding.company_icon` (string, required)
        Você pode adicionar o ícone da sua empresa ao widget para que ele fique mais alinhado com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://mysite.com/icon.svg"
      - `widget.branding.company_logo` (string, required)
        Você pode adicionar o logotipo da sua empresa ao widget para que ele fique mais alinhado com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://mysite.com/logo.svg"
      - `widget.branding.company_name` (string, required)
        Você pode adicionar o nome da sua empresa para ser exibido quando o widget for iniciado pela primeira vez. Por padrão, ele exibirá apenas "Link your account". Quando você adiciona o nome da sua empresa, a mensagem seguirá o formato "[company_name] uses Belvo to connect your account". Para mais informações, consulte a seção company_name do nosso guia de Branding e personalização (Multi-Region).
        Example: "ACME"
      - `widget.branding.company_terms_url` (string, required)
        Você pode adicionar um link para sua política de privacidade (ou termos e condições) na tela inicial do widget que, quando clicado, redirecionará seus usuários para a página da web vinculada. Isso ajuda seus usuários a entenderem melhor qual é o seu caso de uso em relação aos dados que você está solicitando. Para mais informações, consulte a seção company_terms_url do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://belvo.com/terms-service/"
      - `widget.branding.company_terms_version` (string)
        A versão dos seus termos e condições. Use este parâmetro juntamente com company_terms_url para rastrear qual versão dos seus T&C o usuário aceitou durante o fluxo do widget.
        Example: "20260323"
      - `widget.branding.overlay_background_color` (string)
        Você pode adicionar uma cor de sobreposição personalizada para quando o widget carregar em seu aplicativo desktop. Para mais informações, consulte a seção overlay_background_color do nosso guia de Branding e personalização (Multi-Region).
        Example: "#F0F2F4"
      - `widget.branding.social_proof` (boolean)
        Você pode optar por ocultar a mensagem "Mais de 5 milhões de usuários já conectaram com segurança suas contas." que aparece quando seu usuário seleciona sua instituição no widget. Para mais informações, consulte a seção social_proof do nosso guia de Branding e personalização (Multi-Region).
        Example: true
      - `widget.theme` (array)
        Você pode, opcionalmente, adicionar as cores da sua marca ao widget usando o parâmetro theme.

Para mais informações sobre onde essas cores aparecerão no widget, consulte a seção dedicada Adicionar cores personalizadas ao widget do nosso guia de Branding.
      - `widget.theme.css_key` (string, required)
        Nome da variável CSS. Valores possíveis incluem:
- --color-primary-base
- --nav-bar-title-color
- --nav-bar-icon-color
        Example: "--color-primary-base"
      - `widget.theme.value` (string, required)
        O código HEX para o css_key.
        Example: "#907AD6"
    - Registros de Emprego 🇲🇽 México Access Token:
      - `id` (string, required)
        Seu Belvo secretId.
      - `password` (string, required)
        Sua Belvo secretPassword.
      - `scopes` (string, required)
        O parâmetro scopes contém uma lista de permissões que permitem criar um link para o usuário. Este é um parâmetro obrigatório e deve ser enviado exatamente como mostrado.
        Example: "read_institutions,write_links"
      - `fetch_resources` (array, required)
        Uma matriz de recursos para os quais você gostaria de receber uma atualização histórica.

Para Registros de Emprego no México (IMSS e ISSSTE), você pode selecionar os seguintes recursos:
  - EMPLOYMENT_RECORDS

Além disso, você pode optar pelos seguintes recursos específicos de Registros de Emprego (entre em contato com seu representante, pois custos adicionais se aplicam):
  - CURRENT_EMPLOYMENTS (somente IMSS)
  - EMPLOYMENT_METRICS (somente IMSS)
        Enum: "EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS", "EMPLOYMENT_METRICS"
      - `stale_in` (string, required)
        Indica por quanto tempo qualquer dado derivado do usuário deve ser armazenado no banco de dados da Belvo para o link (tanto único quanto recorrente). Por exemplo, se você enviar 90d, a Belvo removerá qualquer dado relacionado ao usuário de seu banco de dados após 90 dias. Para mais informações, confira a seção stale_in do nosso artigo sobre controles de retenção de dados.

> 📘 Informação
>
> A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in. A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in.

Por padrão, a Belvo armazena dados do usuário por 365 dias, a menos que o link seja deletado.
        Example: "42d"
      - `credentials_storage` (string)
        Indica se as credenciais devem ou não ser armazenadas (e a duração para a qual as credenciais serão armazenadas).

- Para links recorrentes, isso é definido como store por padrão (e não pode ser alterado).
- Para links únicos, isso é definido como 365d por padrão.

Pode ser:
  - store para armazenar credenciais (até que o link seja excluído)
  - nostore para não armazenar credenciais
  - Qualquer valor entre 1d e 365d para indicar o número de dias que você deseja que as credenciais sejam armazenadas.

Para mais informações, confira a seção credentials_storage do nosso artigo sobre controles de retenção de dados.
        Example: "27d"
      - `widget` (object, required)
        O objeto widget contém informações adicionais sobre como configurar o widget, incluindo personalização de marca, seus termos e condições, URLs de callback e informações sobre o usuário para o qual você deseja extrair dados.
      - `widget.callback_urls` (object)
        > 📘 Apenas necessário para o Widget Hospedado.

No objeto callback_urls, você deve adicionar links para onde seu usuário deve ser redirecionado nos seguintes casos:

- success (seu usuário conectou suas contas com sucesso)
- exit (seu usuário saiu do widget antes de completar o processo)
- event (ocorreu um erro durante o processo de conexão)

Para mais informações, confira a seção callback_urls no nosso guia do Widget Hospedado (Multi-Region).

> 📘 Eventos de Callback
>
> A Belvo também enviará informações adicionais sobre o evento, dependendo do evento. Para mais informações, certifique-se de conferir a seção Handling callback events do guia do Widget Hospedado (Multi-Region).
      - `widget.callback_urls.success` (string, required)
        A URL para a qual o usuário é redirecionado quando conecta sua conta com sucesso.
        Example: "your_deeplink_here://success"
      - `widget.callback_urls.exit` (string, required)
        A URL para a qual o usuário é redirecionado quando sai do processo antes de conectar sua conta.
        Example: "your_deeplink_here://exit"
      - `widget.callback_urls.event` (string, required)
        A URL para a qual o usuário é redirecionado quando encontra um erro ao conectar sua conta.
        Example: "your_deeplink_here://error"
      - `widget.branding` (object, required)
        No objeto branding, você deve adicionar seu:
- company_icon
- company_logo
- company_name
- company_terms_url

Você também pode, opcionalmente, adicionar uma cor de fundo personalizada para quando o widget abrir, assim como desativar a mensagem da Belvo sobre quantas contas foram conectadas.

Para mais informações sobre as opções de personalização e branding do widget, confira nosso guia dedicado.
      - `widget.branding.company_icon` (string, required)
        Você pode adicionar o ícone da sua empresa ao widget para que ele fique mais alinhado com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://mysite.com/icon.svg"
      - `widget.branding.company_logo` (string, required)
        Você pode adicionar o logotipo da sua empresa ao widget para que ele fique mais alinhado com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://mysite.com/logo.svg"
      - `widget.branding.company_name` (string, required)
        Você pode adicionar o nome da sua empresa para ser exibido quando o widget for iniciado pela primeira vez. Por padrão, ele exibirá apenas "Link your account". Quando você adiciona o nome da sua empresa, a mensagem seguirá o formato "[company_name] uses Belvo to connect your account". Para mais informações, consulte a seção company_name do nosso guia de Branding e personalização (Multi-Region).
        Example: "ACME"
      - `widget.branding.company_terms_url` (string, required)
        Você pode adicionar um link para sua política de privacidade (ou termos e condições) na tela inicial do widget que, quando clicado, redirecionará seus usuários para a página da web vinculada. Isso ajuda seus usuários a entenderem melhor qual é o seu caso de uso em relação aos dados que você está solicitando. Para mais informações, consulte a seção company_terms_url do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://belvo.com/terms-service/"
      - `widget.branding.company_terms_version` (string)
        A versão dos seus termos e condições. Use este parâmetro juntamente com company_terms_url para rastrear qual versão dos seus T&C o usuário aceitou durante o fluxo do widget.
        Example: "20260323"
      - `widget.branding.overlay_background_color` (string)
        Você pode adicionar uma cor de sobreposição personalizada para quando o widget carregar em seu aplicativo desktop. Para mais informações, consulte a seção overlay_background_color do nosso guia de Branding e personalização (Multi-Region).
        Example: "#F0F2F4"
      - `widget.branding.social_proof` (boolean)
        Você pode optar por ocultar a mensagem "Mais de 5 milhões de usuários já conectaram com segurança suas contas." que aparece quando seu usuário seleciona sua instituição no widget. Para mais informações, consulte a seção social_proof do nosso guia de Branding e personalização (Multi-Region).
        Example: true
      - `widget.theme` (array)
        Você pode, opcionalmente, adicionar as cores da sua marca ao widget usando o parâmetro theme.

Para mais informações sobre onde essas cores aparecerão no widget, consulte a seção dedicada Adicionar cores personalizadas ao widget do nosso guia de Branding.
      - `widget.theme.css_key` (string, required)
        Nome da variável CSS. Valores possíveis incluem:
- --color-primary-base
- --nav-bar-title-color
- --nav-bar-icon-color
        Example: "--color-primary-base"
      - `widget.theme.value` (string, required)
        O código HEX para o css_key.
        Example: "#907AD6"
    - Token de Acesso Fiscal 🇲🇽 México:
      - `id` (string, required)
        Seu Belvo secretId.
      - `password` (string, required)
        Sua Belvo secretPassword.
      - `scopes` (string, required)
        O parâmetro scopes contém uma lista de permissões que permitem criar um link para o usuário. Este é um parâmetro obrigatório e deve ser enviado exatamente como mostrado.
        Example: "read_institutions,write_links"
      - `fetch_resources` (array, required)
        Um array de recursos para os quais você gostaria de receber uma atualização histórica.

Para Fiscal Mexico (SAT), você pode selecionar os seguintes recursos:
  - FINANCIAL_STATEMENTS
  - INVOICES
  - TAX_COMPLIANCE_STATUS
  - TAX_RETENTIONS
  - TAX_RETURNS
  - TAX_STATUS
        Enum: "FINANCIAL_STATEMENTS", "INVOICES", "TAX_COMPLIANCE_STATUS", "TAX_RETENTIONS", "TAX_RETURNS", "TAX_STATUS"
      - `stale_in` (string, required)
        Indica por quanto tempo qualquer dado derivado do usuário deve ser armazenado no banco de dados da Belvo para o link (tanto único quanto recorrente). Por exemplo, se você enviar 90d, a Belvo removerá qualquer dado relacionado ao usuário de seu banco de dados após 90 dias. Para mais informações, confira a seção stale_in do nosso artigo sobre controles de retenção de dados.

> 📘 Informação
>
> A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in. A Belvo removerá dados apenas para links que não foram atualizados no período que você fornecer em stale_in.

Por padrão, a Belvo armazena dados do usuário por 365 dias, a menos que o link seja deletado.
        Example: "42d"
      - `credentials_storage` (string)
        Indica se as credenciais devem ou não ser armazenadas (e a duração para a qual as credenciais serão armazenadas).

- Para links recorrentes, isso é definido como store por padrão (e não pode ser alterado).
- Para links únicos, isso é definido como 365d por padrão.

Pode ser:
  - store para armazenar credenciais (até que o link seja excluído)
  - nostore para não armazenar credenciais
  - Qualquer valor entre 1d e 365d para indicar o número de dias que você deseja que as credenciais sejam armazenadas.

Para mais informações, confira a seção credentials_storage do nosso artigo sobre controles de retenção de dados.
        Example: "27d"
      - `widget` (object, required)
        O objeto widget contém informações adicionais sobre como configurar o widget, incluindo personalização de marca, seus termos e condições, URLs de callback e informações sobre o usuário para o qual você deseja extrair dados.
      - `widget.callback_urls` (object)
        > 📘 Apenas necessário para o Widget Hospedado.

No objeto callback_urls, você deve adicionar links para onde seu usuário deve ser redirecionado nos seguintes casos:

- success (seu usuário conectou suas contas com sucesso)
- exit (seu usuário saiu do widget antes de completar o processo)
- event (ocorreu um erro durante o processo de conexão)

Para mais informações, confira a seção callback_urls no nosso guia do Widget Hospedado (Multi-Region).

> 📘 Eventos de Callback
>
> A Belvo também enviará informações adicionais sobre o evento, dependendo do evento. Para mais informações, certifique-se de conferir a seção Handling callback events do guia do Widget Hospedado (Multi-Region).
      - `widget.callback_urls.success` (string, required)
        A URL para a qual o usuário é redirecionado quando conecta sua conta com sucesso.
        Example: "your_deeplink_here://success"
      - `widget.callback_urls.exit` (string, required)
        A URL para a qual o usuário é redirecionado quando sai do processo antes de conectar sua conta.
        Example: "your_deeplink_here://exit"
      - `widget.callback_urls.event` (string, required)
        A URL para a qual o usuário é redirecionado quando encontra um erro ao conectar sua conta.
        Example: "your_deeplink_here://error"
      - `widget.branding` (object, required)
        No objeto branding, você deve adicionar seu:
- company_icon
- company_logo
- company_name
- company_terms_url

Você também pode, opcionalmente, adicionar uma cor de fundo personalizada para quando o widget abrir, assim como desativar a mensagem da Belvo sobre quantas contas foram conectadas.

Para mais informações sobre as opções de personalização e branding do widget, confira nosso guia dedicado.
      - `widget.branding.company_icon` (string, required)
        Você pode adicionar o ícone da sua empresa ao widget para que ele fique mais alinhado com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://mysite.com/icon.svg"
      - `widget.branding.company_logo` (string, required)
        Você pode adicionar o logotipo da sua empresa ao widget para que ele fique mais alinhado com sua marca. Para mais informações, consulte a seção company_icon do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://mysite.com/logo.svg"
      - `widget.branding.company_name` (string, required)
        Você pode adicionar o nome da sua empresa para ser exibido quando o widget for iniciado pela primeira vez. Por padrão, ele exibirá apenas "Link your account". Quando você adiciona o nome da sua empresa, a mensagem seguirá o formato "[company_name] uses Belvo to connect your account". Para mais informações, consulte a seção company_name do nosso guia de Branding e personalização (Multi-Region).
        Example: "ACME"
      - `widget.branding.company_terms_url` (string, required)
        Você pode adicionar um link para sua política de privacidade (ou termos e condições) na tela inicial do widget que, quando clicado, redirecionará seus usuários para a página da web vinculada. Isso ajuda seus usuários a entenderem melhor qual é o seu caso de uso em relação aos dados que você está solicitando. Para mais informações, consulte a seção company_terms_url do nosso guia de Branding e personalização (Multi-Region).
        Example: "https://belvo.com/terms-service/"
      - `widget.branding.company_terms_version` (string)
        A versão dos seus termos e condições. Use este parâmetro juntamente com company_terms_url para rastrear qual versão dos seus T&C o usuário aceitou durante o fluxo do widget.
        Example: "20260323"
      - `widget.branding.overlay_background_color` (string)
        Você pode adicionar uma cor de sobreposição personalizada para quando o widget carregar em seu aplicativo desktop. Para mais informações, consulte a seção overlay_background_color do nosso guia de Branding e personalização (Multi-Region).
        Example: "#F0F2F4"
      - `widget.branding.social_proof` (boolean)
        Você pode optar por ocultar a mensagem "Mais de 5 milhões de usuários já conectaram com segurança suas contas." que aparece quando seu usuário seleciona sua instituição no widget. Para mais informações, consulte a seção social_proof do nosso guia de Branding e personalização (Multi-Region).
        Example: true
      - `widget.theme` (array)
        Você pode, opcionalmente, adicionar as cores da sua marca ao widget usando o parâmetro theme.

Para mais informações sobre onde essas cores aparecerão no widget, consulte a seção dedicada Adicionar cores personalizadas ao widget do nosso guia de Branding.
      - `widget.theme.css_key` (string, required)
        Nome da variável CSS. Valores possíveis incluem:
- --color-primary-base
- --nav-bar-title-color
- --nav-bar-icon-color
        Example: "--color-primary-base"
      - `widget.theme.value` (string, required)
        O código HEX para o css_key.
        Example: "#907AD6"

## Response 200 fields (application/json):

  - `access` (string)
    O token de acesso a ser usado para autenticar o widget.
    Example: "jwt_test_ey.........."

  - `refresh` (string)
    O token de atualização a ser usado para autenticar o widget.
    Example: "jwt_test_ey.........."

## Response 500 fields (application/json):

  - `code` (string)
    Um código de erro único (unexpected_error) que permite classificar e tratar o erro de forma programática.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Uma breve descrição do erro.

Para erros unexpected_error, a descrição é:

  - Belvo não consegue processar a solicitação devido a um problema interno do sistema ou a uma resposta não suportada de uma instituição.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"