Things to keep in mind when integrating Open Finance Regulated data that can be different from Direct Connections.
Cartões de Crédito#
As transações de cartão de crédito se comportam de maneira diferente em cada instituição; como regra geral, as instituições fornecerão novas compras diariamente e, uma vez que a fatura esteja fechada/vencida, retornará todas as transações associadas a ela.
Parcelas Futuras#
Quando um usuário faz várias parcelas de uma compra, as instituições se comportam de maneiras diferentes.
- A maioria das instituições retornará a primeira parcela nas atualizações diárias; essa informação é retornada quando recuperamos as informações semanais das transações atuais.
- BTGPactual Investimentos (614), as parcelas futuras (número da parcela >= 2) são recuperadas na primeira conexão com o status
PENDING.
Todas as transações serão atualizadas para postadas, com seu correspondente billId uma vez que a fatura esteja fechada.
Parcelas#
- Algumas instituições, como XP Banking (602), podem mostrar transações para a compra completa da operação realizada em parcelas. Isso será a soma de todas as parcelas e nunca terá um billId.
Faturas#
Devido a uma limitação da API das Instituições Financeiras, faturas abertas não são retornadas até que as faturas estejam fechadas ou vencidas (isso depende da FI).
Uma vez que a fatura é retornada, todas as transações terão a relação billId atribuída. Até que a fatura apareça na FI, não poderemos criar a Bill nem vinculá-la ao seu correspondente billId.
Além disso, algumas transações são retornadas apenas na lista de transações da fatura, então serão retornadas uma vez que a fatura tenha aparecido na FI (ou seja, Parcelas Futuras).
Nota: Vencido significa que passou da data de vencimento, não relacionado ao status de pagamento.
Conta Corrente#
Transações que estão bloqueadas ou sendo processadas aparecerão como PENDING até que as transações sejam concluídas. O número de dias que esse processo pode levar varia entre instituições e tipos de transações. Quando a transação está bloqueada, ela será somada ao blockedBalance da conta. Uma vez que as transações tenham sido processadas (Compensado), elas aparecerão como postadas, e o saldo mudará de blockedBalance para o balance da conta.
Caution
Contas correntes têm um limite rígido de 260 recursos; além desse limite, as contas não são coletadas e um aviso será adicionado nos detalhes de status do item. Se você tiver mais contas, entre em contato com o suporte.
Diferenças conhecidas entre conectores#
XP#
| Regulado | Direto | |
|---|---|---|
| Auto-sync | Sim | Não (PJ são atualizáveis) |
| MFA | Não | Sim (PJ não) |
| Ativos COE | Não | Sim |
| Ativos de Segurança | Não | Sim |
| Tempo de transações de investimento (INITIAL_UPDATE) | 1 ano | 4 anos |
| Total de investimentos retirados antes da primeira conexão | Não | Sim |
| Transações de portabilidade de ativos | Não | Sim |
Perguntas Frequentes (FAQ)#
-
Na primeira conexão, os conectores de Open Finance retornam investimentos totalmente retirados?
- Não, apenas investimentos ativos no momento da primeira conexão são retornados. A partir desse ponto, se você retirar totalmente um desses investimentos, ele mudará de status para TOTAL_WITHDRAWAL.
-
O Itau PJ OF (618) retorna transações consolidadas (SISPAG CONSOLIDADO, PIX QRS CONSOLIDADO) ou transações detalhadas?
- Ele sempre retorna transações detalhadas, com o CPF / CNPJ da contraparte dentro do paymentData.
-
O que acontece quando o consentimento de um Item expira?
- Os metadados do item ainda estariam disponíveis, mas os dados do usuário não estariam disponíveis. Os clientes serão obrigados a solicitar um novo consentimento de seu usuário no item existente para renovar o consentimento. Veja Consents Docs para mais informações.