Saltar para o conteúdo principal
GET
curl
O endpoint Obter uma ligação bancária da Didit devolve o estado de uma ligação e, quando esta estiver concluída, o seu connection_id e check_id. Chame-o a partir do seu servidor depois de onSuccess ou de bank.link.completed: nunca confie num ID de ligação enviado por um navegador. Uma ligação falhada devolve 200 com status: failed e um error com um código como duplicate_conflict ou reduced_grant.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, obtida em Developers -> API keys na Business Console. A chave principal tem acesso total. Uma chave com nome pode ter o âmbito limitado: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou apenas a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que não foi enviada nenhuma chave, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe os URLs de imagem, vídeo e PDF como null, e uma chave sem escrita em sessões recebe os links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

id
string<uuid>
obrigatório

O id da ligação.

Resposta

A ligação.

Uma execução do Bank Link para uma pessoa: ligar um banco ou renovar uma ligação. Confirme pessoalmente a ligação com get_link: nunca confie num id enviado pelo navegador.

id
string<uuid>
obrigatório

Identificador do link.

mode
enum<string>
obrigatório
Opções disponíveis:
connect,
renew
access
enum<string>
obrigatório
Opções disponíveis:
one_time,
ongoing
status
enum<string>
obrigatório

Estado do link. completed, cancelled, expired e failed são estados finais.

Opções disponíveis:
created,
opened,
connecting,
completed,
cancelled,
expired,
failed
url
string<uri> | null
obrigatório

A página alojada para onde enviar a pessoa. Devolvida apenas quando a ligação é criada; null nas leituras seguintes, porque o token não é guardado.

client_token
string | null
obrigatório

O token do Bank Link incorporado da Didit, que ainda não foi disponibilizado: abra url hoje. Devolvido apenas quando a ligação é criada; null nas leituras seguintes. Tem uma única finalidade e uma duração curta. Não contém dados pessoais. Nunca o registe.

expires_at
string<date-time>
obrigatório

Quando uma ligação não resgatada deixa de funcionar.

connection_id
string<uuid> | null
obrigatório

A ligação criada ou renovada por esta hiperligação, quando status é completed.

check_id
string<uuid> | null
obrigatório

O resultado da verificação de propriedade desta ligação, quando foi pedido ownership.compare com valor diferente de none.

reused
boolean
obrigatório

true quando a ligação foi concluída como renovação de uma ligação existente, porque a pessoa já partilha exatamente estas contas (duplicates: reuse). Nada é cobrado duas vezes.

error
object | null
obrigatório

Motivo da falha da ligação, quando status é failed. Caso contrário, null.

quote
object
obrigatório

O preço de uma ligação, fixado na criação. O valor cobrado é o da cotação. As leituras nunca são faturadas.

vendor_data
string | null
obrigatório

A sua referência do pedido.

Última modificação em 22 de novembro de 2026