404 até que o acesso em produção seja anunciado.
Acesso único e contínuo
O acesso contínuo só funciona em bancos que o permitem.
Consulte o endpoint de instituições ou leia a página de cobertura.
Quando um banco não consegue manter o acesso aberto, a pessoa é informada de que o banco não permite acesso contínuo e precisa escolher outro banco.
Defina
allow_one_time_fallback: true para que a pessoa continue com uma leitura única depois de confirmar o acesso reduzido na própria tela: a conexão fica então como one_time.
Status
status_reason é um dos seguintes valores: collection_complete, consent_expired, consent_lapsed, bank_requires_sign_in, revoked_by_end_user, revoked_by_bank, revoked_by_customer, insufficient_balance, paused_by_customer (reservado, nenhum endpoint o define atualmente) e first_sync_failed.
Consentimento
O banco define o fim do consentimento, até oconsent_days que você solicitou.
Cada conexão mostra suas datas reais em consent:
expires_aterenew_by: o fim do consentimento. Renove antes dele para não ter interrupção.renewable_until: o último momento em que a mesma conexão pode ser reativada depois que o consentimento terminou.renewed_count,version,scopes_grantedeaccounts_granted: o que foi concedido e quantas vezes ele foi renovado.
Renovação
Uma renovação mantém o id da conexão e todos os ids de conta, e o histórico continua sem duplicatas.- A Didit envia
bank.connection.consent_expiring14, 7 e 1 dia antes do fim. - Chame
POST /v3/bank/connections/{id}/renew/. Ele responde409 renewal_not_neededenquanto restarem mais de 30 dias e409 renewal_window_expiredapósconsent.renewable_until. Caso contrário, responde201com um link de renovação.
renewal_required: os dados permanecem acessíveis como estavam na última sincronização e nada é cobrado.
Após consent.renewable_until, ela passa para revoked com status_reason: consent_lapsed, e a pessoa se conecta novamente.
Para o fluxo completo, veja Renovar um consentimento bancário.
Interromper o acesso
Interromper o acesso não é excluir.
Leia Dados, consentimento e exclusão para saber exatamente o que a exclusão remove.
Uma conexão excluída
Uma conexão excluída responde apenasid, status (deleted), status_reason, created_at e erasure.
status_reason é deleted_by_customer, consent_lapsed, retention_elapsed ou application_deleted.
Todos os outros campos estão ausentes.
Duplicados
Um novo link que resolve exatamente para as contas que você já compartilha com o mesmoend_user.reference no mesmo banco é concluído como uma renovação dessa conexão (reused: true) e não cobra duas vezes.
Qualquer outra sobreposição encerra o link com failed, duplicate_conflict e conflicts_with, antes que qualquer coisa seja armazenada ou cobrada.
Renove a conexão existente ou crie o link novamente com "duplicates": "allow" para uma segunda conexão independente.
Gerencie as conexões dos seus clientes
- Listagem com filtros:
GET /v3/bank/connections/aceitastatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeecreated_after. - Veja quanto custa cada conexão com o objeto
billing: a unidade, o preço e o mês já liquidado.