Saltar para o conteúdo principal
A API de dados bancários da Didit liga a conta bancária de uma pessoa através do Bank Link, mantém a ligação ativa enquanto a pessoa o permitir e disponibiliza as suas contas, saldos e transações. A URL base é https://verification.didit.me/v3/ e a autenticação faz-se com a chave de API da sua aplicação no cabeçalho x-api-key, como em todas as APIs autónomas. Todas as operações de escrita aceitam um Idempotency-Key. As listagens aceitam limit (predefinição 100, máximo 500) e continuam com cursor, exceto as leituras de transações: a leitura por intervalo de datas continua com page_token, e o feed de alterações aceita um cursor persistente e continua a paginação com page_token. As leituras nunca são faturadas. Os erros incluem code, message, request_id, field, next_action e retry_after: tome decisões com base em code. Todas as operações, exceto a verificação de conta, exigem uma chave de API que tenha a permissão de dados bancários: o acesso total não inclui esta permissão. A verificação de conta não usa essa permissão: exige uma chave de API com acesso de escrita a sessões, ou acesso total. Os dados bancários estão disponíveis para aplicações de sandbox. As chamadas de uma aplicação em produção respondem com 404 até o acesso em produção ser anunciado, e no sandbox não é cobrado nada.

Ligações

Criar uma ligação

POST /v3/bank/links/

Obter uma ligação

GET /v3/bank/links/{id}/

Cancelar uma ligação

POST /v3/bank/links/{id}/cancel/

Ligações

Listar ligações

GET /v3/bank/connections/

Obter uma ligação

GET /v3/bank/connections/{id}/

Atualizar

POST /v3/bank/connections/{id}/refresh/

Renovar

POST /v3/bank/connections/{id}/renew/

Revogar

POST /v3/bank/connections/{id}/revoke/

Eliminar

DELETE /v3/bank/connections/{id}/

Execuções de sincronização

GET /v3/bank/connections/{id}/sync-runs/

Obter uma execução de sincronização

GET /v3/bank/connections/{id}/sync-runs/{sync_id}/

Contas, saldos e transações

Listar contas

GET /v3/bank/connections/{id}/accounts/

Obter uma conta

GET /v3/bank/accounts/{account_id}/

Obter saldos

GET /v3/bank/accounts/{account_id}/balances/

Listar transações

GET /v3/bank/accounts/{account_id}/transactions/

Feed de alterações nas transações

GET /v3/bank/connections/{id}/transactions/sync/

Bancos e cobertura

Listar instituições

GET /v3/bank/institutions/

Obter uma instituição

GET /v3/bank/institutions/{id}/

Obter cobertura

GET /v3/bank/coverage/

Verificação de conta

POST /v3/bank/account-check/

Guias

SDKs de servidor

Os sete SDKs de servidor expõem estas operações no recurso bank, com o nome da operação: create_link, get_connection, sync_transactions e assim por diante.
Última modificação em 22 de novembro de 2026