Skip to main content
GET
cURL
Este endpoint inicia o fluxo de conexão Open Finance via WhatsApp com funcionalidades baseadas no plano do usuário.

Descrição

O endpoint GET /tools/api/get-open-finance-connection-flow permite que usuários conectem suas contas bancárias através do Open Finance diretamente pelo WhatsApp. A experiência varia conforme o plano:
  • Premium: Fluxo interativo completo com lista de bancos disponíveis
  • Basic/Pro: Notificação sobre limitações do plano e sugestão de upgrade

Autenticação

Este endpoint requer autenticação via Bearer token.
string
required
Bearer token com a API key do usuário. Formato: Bearer sk-your-api-key-here

Parâmetros de Query

string
required
Parâmetro interno para indicar requisições via MCP. Use s=s para requisições MCP.

Resposta

Sucesso (200)

Erro de Dados Incompletos (400)

Erro de Autenticação (401)

Campos da Resposta

string
required
Status da operação: accepted indica que a mensagem foi aceita pelo WhatsApp
string
required
Mensagem descritiva sobre o status da operação

Exemplos de Uso

cURL

JavaScript

Python

Códigos de Status

  • 200: Sucesso - Fluxo WhatsApp enviado
  • 400: Dados do usuário incompletos (número de telefone não cadastrado)
  • 401: Erro de autenticação ou assinatura
  • 500: Erro interno do servidor

Experiência por Plano

Plano Premium

Usuários Premium recebem um fluxo interativo completo via WhatsApp contendo:
  • Lista de bancos disponíveis para conexão
  • Interface de seleção integrada
  • Instruções passo a passo
  • Conexão direta com as instituições financeiras

Planos Basic e Pro

Usuários Basic e Pro recebem uma notificação via WhatsApp informando:
  • Que a funcionalidade está disponível apenas no plano Premium
  • Benefícios do upgrade para Premium
  • Link para fazer upgrade
  • Informações de contato para suporte

Requisitos

Configuração Necessária

Para usar este endpoint, o usuário precisa ter:
  1. Número de telefone cadastrado e verificado
  2. WhatsApp Business API configurado para a conta
  3. Assinatura ativa (qualquer plano)

Bancos Suportados (Premium)

O fluxo Premium oferece conexão com os principais bancos brasileiros via Open Finance:
  • Nubank
  • Itaú
  • Bradesco
  • Banco do Brasil
  • Santander
  • Caixa Econômica Federal
  • Inter
  • E outros participantes do Open Finance

Casos de Uso

Onboarding de Usuários

Integre este endpoint no fluxo de onboarding para facilitar a conexão de contas bancárias.

Reconexão de Contas

Use quando contas precisarem ser reconectadas devido a vencimento de tokens ou mudança de credenciais.

Adicionar Novas Contas

Permita que usuários adicionem novas contas bancárias a qualquer momento.

Chatbot de Suporte

Integre em chatbots para permitir que usuários iniciem a conexão através de conversas.
O fluxo é enviado via WhatsApp Business API. O usuário precisa ter um número de telefone válido cadastrado em sua conta Pierre Finance.
Para uma melhor experiência do usuário, certifique-se de que o número de telefone está cadastrado e verificado antes de chamar este endpoint.
Este endpoint dispara uma mensagem via WhatsApp. Evite chamadas excessivas para não gerar spam para o usuário. Implemente debouncing ou rate limiting no seu código.

Segurança

Open Finance

A conexão via Open Finance é segura e regulamentada pelo Banco Central do Brasil:
  • Autenticação forte (multi-fator)
  • Criptografia end-to-end
  • Consentimento explícito do usuário
  • Prazo de validade dos acessos
  • Auditoria completa de acessos

Privacidade

  • Credenciais bancárias nunca são armazenadas
  • Tokens de acesso são temporários e renováveis
  • Dados são criptografados em repouso e em trânsito
  • Conformidade com LGPD

Upgrade para Premium

Para acessar o fluxo completo de conexão:
  1. Acesse pierre.finance/plans
  2. Selecione o plano Premium
  3. Complete o upgrade
  4. Reinicie o fluxo de conexão
Benefícios do Premium incluem:
  • ✅ Conexão via Open Finance integrada
  • ✅ Até 30 lembretes de pagamento
  • ✅ Até 30 alertas de gastos
  • ✅ Suporte prioritário
  • ✅ Análises avançadas

Authorizations

Authorization
string
header
required

API key in Bearer token format. Example: Bearer sk-your-api-key-here

Response

Fluxo iniciado com sucesso

status
string
Example:

"accepted"

message
string
Example:

"WhatsApp flow sent successfully"