404 até que o acesso em produção seja anunciado.
Acesso pontual e contínuo
O acesso contínuo só funciona num banco quando esse banco o permite.
Consulte o endpoint de instituições ou leia a página de cobertura.
Quando um banco não pode manter o acesso aberto, a pessoa é informada de que o banco não permite acesso contínuo e de que tem de escolher outro banco.
Defina
allow_one_time_fallback: true para permitir que a pessoa continue com uma leitura pontual depois de confirmar o acesso reduzido no seu próprio ecrã: a ligação fica então one_time.
Estados
Os valores de
status_reason são 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é ao valor deconsent_days que pediu.
Cada ligação mostra as datas reais em consent:
expires_aterenew_by: o fim do consentimento. Renove antes desse momento para não haver interrupção.renewable_until: o último momento em que a mesma ligação pode ser reativada após o fim do consentimento.renewed_count,version,scopes_grantedeaccounts_granted: o que foi concedido e quantas vezes foi renovado o consentimento.
Renovação
Uma renovação mantém o id da ligação e todos os ids de conta, e o histórico continua sem duplicados.- A Didit envia
bank.connection.consent_expiring14, 7 e 1 dia antes do fim. - Chame
POST /v3/bank/connections/{id}/renew/. Responde com409 renewal_not_neededenquanto restarem mais de 30 dias e com409 renewal_window_expireddepois deconsent.renewable_until. Caso contrário, responde com201e uma ligação de renovação.
renewal_required: os dados continuam legíveis tal como foram sincronizados pela última vez, e não é cobrado nada.
Depois de consent.renewable_until, a ligação fica revoked com status_reason: consent_lapsed, e a pessoa tem de voltar a estabelecer a ligação.
Para o fluxo completo, consulte Renovar um consentimento bancário.
Interromper o acesso
Interromper o acesso não é o mesmo que eliminar.
Consulte Dados, consentimento e eliminação para saber exatamente o que a eliminação remove.
Uma ligação eliminada
Uma ligação eliminada devolve apenasid, status (deleted), status_reason, created_at e erasure.
status_reason é deleted_by_customer, consent_lapsed, retention_elapsed ou application_deleted.
Nenhum outro campo está presente.
Duplicados
Uma nova ligação que resolve exatamente para as contas que já partilha com o mesmoend_user.reference no mesmo banco é concluída como uma renovação dessa conexão (reused: true), sem qualquer cobrança duplicada.
Qualquer outra sobreposição termina a ligação com failed e duplicate_conflict e conflicts_with, antes de qualquer informação ser armazenada ou de ser efetuada qualquer cobrança.
Renove a conexão existente ou crie novamente a ligação com "duplicates": "allow" para obter uma segunda conexão independente.
Gerir as ligações dos seus clientes
- Listar com filtros:
GET /v3/bank/connections/aceitastatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeecreated_after. - Veja o custo de uma ligação com o seu objeto
billing: a unidade, o preço e o mês já liquidado.