> ## 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.

# Ligação bancária alojada: envie uma ligação, sem código na sua página

> Crie uma ligação no seu servidor e envie a pessoa para o URL. A Didit aloja os ecrãs e reencaminha-a para o seu `redirect_url` ao concluir.

O Bank Link alojado da Didit é a forma atual de ligar a um banco: cria uma ligação, envia a pessoa para o seu `url`, e a Didit mostra todos os ecrãs na sua própria página.
Os dados bancários estão disponíveis para aplicações sandbox; as chamadas de uma aplicação em produção devolvem `404` até ser anunciado o acesso ao ambiente de produção.

## Criar a ligação e enviá-la à pessoa

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "end_user": { "reference": "client-7731" },
    "vendor_data": "client-7731"
  }'
```

Redirecione o navegador para o `url` da resposta, ou coloque-o num e-mail ou numa mensagem.
O `url` só é devolvido quando a ligação é criada, e deixa de funcionar quando a ligação expira (60 minutos por predefinição, de 5 minutos a 24 horas com `expires_in`).

## O que acontece no fim

* Com um `redirect_url` que a Didit aceita, o navegador volta a esse endereço. Consulte [Volte ao seu site](https://docs.didit.me/pt/integration/bank-link/return-to-your-site.md).
* Sem um, o fluxo termina na página de resultado da Didit.
* Em qualquer dos casos, o webhook `bank.link.completed` e `GET /v3/bank/links/{id}/` indicam-lhe o resultado.

## Confirmar no seu servidor

Quando `bank.link.completed` chegar, chame `GET /v3/bank/links/{id}/` com o ID da ligação que guardou para esse utilizador.
A resposta devolve `status: completed` com o `connection_id`, ou uma falha final com um `error.code`.
Em seguida, continue com o [guia de início rápido](https://docs.didit.me/pt/core-technology/bank-verification/quickstart.md#passo-4-receber-os-webhooks-e-confirmar).


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