> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API de dados bancários: ligar bancos e ler transações

> Ligue a conta bancária do cliente uma vez com a Bank Link, verifique quem é o titular e continue a ler saldos e transações com uma API e um só preço na Didit.

Os dados bancários da API da Didit permitem que o seu produto ligue a conta bancária de uma pessoa ou de uma empresa através do Bank Link, verifique quem é o titular da conta e consulte os saldos e as transações enquanto o banco e a pessoa o permitirem.
Utiliza uma única chave de API, um único endpoint de webhook e uma única tabela de preços, os mesmos que utiliza para a verificação de identidade, a verificação de empresas e a triagem AML.

> [!NOTE]
>
> **Disponibilidade.** Os dados bancários estão disponíveis para aplicações em sandbox.
> As chamadas de uma aplicação em produção devolvem `404` até o acesso em produção ser anunciado, e em sandbox não é cobrado nada.
> Comece pelo [guia de início rápido](https://docs.didit.me/pt/core-technology/bank-verification/quickstart.md).
> A [página de cobertura](https://docs.didit.me/pt/core-technology/bank-verification/coverage.md) e o [endpoint de instituições](https://docs.didit.me/pt/standalone-apis/bank-institutions-list.md) mostram o que cada banco suporta.

## Uma ideia numa frase

Uma **ligação** cria uma **conexão**, uma conexão tem **contas**, e uma conta tem **saldos** e **transações**.

| Objeto | O que é | Duração |
| - | - | - |
| Ligação | Uma execução do [Bank Link](https://docs.didit.me/pt/core-technology/bank-verification/bank-link.md) para uma pessoa: ligar um banco ou renovar uma conexão. | Minutos a horas, depois expira. |
| Conexão | A permissão da pessoa para a sua aplicação ler dados de um banco. Inclui o consentimento, o estado de sincronização e o estado. | Acesso único: até à recolha terminar. Acesso contínuo: até ao consentimento terminar, renovado com a frequência que a pessoa autorizar. |
| Conta | Uma conta dentro de uma conexão, com um identificador que nunca muda enquanto a conexão existir. | Enquanto durar a conexão. O identificador mantém-se igual após cada renovação. |
| Saldo | Um valor de uma conta, com um tipo, numa data de referência. | Substituído a cada sincronização. |
| Transação | Um movimento de uma conta, com um identificador estável. | Enquanto a conexão existir. |

## Duas formas de obter dados bancários e duas outras verificações bancárias

| O que pretende | Utilizar | Preço, em resumo |
| - | - | - |
| Ler saldos e transações uma vez | Uma ligação com `access: one_time` | Por verificação, consulte os [preços](https://docs.didit.me/pt/getting-started/bank-verification-pricing.md#dados-bancários-e-acesso-contínuo) |
| Continuar a ler saldos e transações durante meses | Uma ligação com `access: ongoing` | Por ligação ativa, por mês |
| Confirmar que uma conta bancária pertence a um nome antes de efetuar um pagamento | [Verificação de conta](https://docs.didit.me/pt/standalone-apis/bank-account-check.md), sem início de sessão | Por verificação respondida |
| Confirmar que a pessoa que inicia sessão é titular da conta | Uma ligação com `ownership.compare`, ou o [passo de Verificação bancária](https://docs.didit.me/pt/core-technology/bank-verification/verification-methods.md) de uma sessão de verificação | Por início de sessão concluído |

## O que a diferencia

* **Uma plataforma.** A verificação de identidade, a verificação de empresas, a triagem AML e os dados bancários partilham uma chave de API, um contrato e uma consola.
* **Uma ligação para acesso único ou contínuo.** A mesma Bank Link alojada serve ambos os casos.
* **A comparação do titular é opcional.** Compare o titular da conta com uma pessoa ou empresa verificada pela Didit, ou dispense a comparação se só precisar dos dados.
* **Preços públicos de pagamento por utilização.** Consulte a [página de preços](https://docs.didit.me/pt/getting-started/bank-verification-pricing.md).
* **IDs estáveis e um feed de alterações.** As contas e as transações mantêm os seus IDs nas renovações, e um feed de alterações com um cursor persistente devolve-lhe apenas o que mudou.
* **Um sandbox que cobre os casos mais difíceis.** O Didit Test Bank e os respetivos clientes de teste incluem contas empresariais, histórico longo, transações pendentes e bancos de acesso único.

## Escolha o seu caminho

> [card] [Início rápido](https://docs.didit.me/pt/core-technology/bank-verification/quickstart.md)
>
> Pedidos para copiar e colar, do zero às primeiras transações, com uma chave de sandbox.

> [card] [Feed contínuo para contabilidade](https://docs.didit.me/pt/use-cases/bank-data-for-accounting.md)
>
> Um feed diário de saldos e transações para cada um dos seus clientes.

> [card] [Verificar uma conta antes de um pagamento](https://docs.didit.me/pt/use-cases/verify-a-payout-account.md)
>
> Verifique o titular da conta sem iniciar sessão.

> [card] [Mostrar Bank Link](https://docs.didit.me/pt/core-technology/bank-verification/bank-link.md)
>
> Encaminhe a pessoa para a ligação alojada e reencaminhe-a para o seu site.

## Onde continuar

* [Ligações](https://docs.didit.me/pt/core-technology/bank-verification/connections.md): acesso contínuo, consentimento, renovação e estados de uma ligação.
* [Contas, saldos e transações](https://docs.didit.me/pt/core-technology/bank-verification/accounts-balances-transactions.md): o modelo de dados e os campos que cada banco envia.
* [Webhooks](https://docs.didit.me/pt/core-technology/bank-verification/webhooks.md): os eventos `bank.*` e como os utilizar.
* [Sandbox](https://docs.didit.me/pt/core-technology/bank-verification/sandbox.md): o Didit Test Bank e os respetivos clientes de teste.
* [Dados, consentimento e eliminação](https://docs.didit.me/pt/core-technology/bank-verification/data-consent-and-deletion.md): o que a pessoa aceita, como terminar o acesso e o que a eliminação remove.
* [Preços](https://docs.didit.me/pt/getting-started/bank-verification-pricing.md): todos os preços em texto.
* [Referência da API](https://docs.didit.me/pt/standalone-apis/bank-data.md): todos os endpoints.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.