Open Finance
Contas, transações e investimentos por consentimento, com widget de conexão hospedado e webhooks a cada mudança de status.
Itaú
CHECKING_ACCOUNT
currentBalance
R$47.635,27
Cartão de crédito
R$ 3.184,40
fatura aberta
Investimentos
R$ 212.540,00
CDB, 110% CDI
Transações
TRANSACTIONS_CREATEDClientes e parceiros
A API de Open Finance da Openi permite que a sua aplicação leia, com o consentimento do usuário, contas, transações e investimentos de instituições financeiras brasileiras em um único formato. Seu backend cria uma sessão de conexão, o usuário autoriza o acesso no widget Connect e os dados chegam por API e por webhooks.
Seu backend chama POST /v1/connect-sessions com a API Key e recebe uma connectUrl temporária.
O Connect cuida da escolha da instituição, das credenciais e do OAuth. Nada disso passa pela sua aplicação.
O usuário volta ao seu redirectUrl com itemId e status. Os webhooks avisam cada mudança da conexão.
Com o itemId você lista contas, transações e investimentos, com paginação e filtros por data.
curl -X POST "$OPENI_API/v1/connect-sessions" \
-H "Authorization: Bearer $OPENI_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "redirectUrl": "https://app.suaempresa.com.br/callback" }'
# A resposta traz a connectUrl.
# Depois da conexão, o usuário volta para:
# https://app.suaempresa.com.br/callback?itemId=...&status=successLista de instituições, formulário, OAuth e progresso da sincronização em uma interface pronta. A sessão expira sozinha e a chave dela não dá acesso a dados de conta.
Liste e busque instituições por nome. Cada conector informa os parâmetros exigidos para criar a conexão.
Pagador, recebedor, tipo de operação e descrição original preservada em cada transação.
Posições, snapshots e movimentações das carteiras conectadas.
Eventos de item e de transação, com retentativas e orientação de idempotência na documentação.
Leia os endpoints, copie os exemplos acima e solicite as credenciais para fazer as mesmas chamadas com os seus dados.