Changelog

​

📊 Extrato Bancário (PDF/CSV)

​

Novos Endpoints

​

Funcionalidades

• PDF profissional: Relatório completo com resumo financeiro, movimentação mensal, detalhamento por mês e tabela de transações
• CSV estruturado: Planilha com cabeçalho informativo e todas as colunas de transações
• Conteúdo personalizável: Escolha quais seções e colunas incluir no relatório via campo options
• Processamento assíncrono: Solicite o extrato e acompanhe o status em tempo real via listener ou polling
• Datas flexíveis: Campos startDate e endDate aceitam timestamp em ms ou string YYYY-MM-DD
• Período de até 365 dias: Gere relatórios abrangentes de longos períodos

​

Seções Configuráveis (PDF)

​

Painel do Cliente

​

🔑 APIs de Gerenciamento de Chaves PIX

​

Novos Endpoints

​

Tipos de Chave Suportados

• EVP - Chave aleatória (UUID gerado automaticamente)
• CPF - Deve ser igual ao documento da conta
• CNPJ - Deve ser igual ao documento da conta
• EMAIL - Formato válido, máx. 77 caracteres
• PHONE - Formato +55DDNNNNNNNNN

​

Validações de Segurança

​

Novos Códigos de Erro

​

💸 Novas APIs de Transferência Interna

​

Novos Endpoints

​

Funcionalidades

• Transferência Interna: Movimente valores entre contas BaaS do mesmo parceiro instantaneamente e sem taxas
• Consulta de Pagamento: Acompanhe o status de qualquer pagamento PIX usando o End-to-End ID
• Suporte a conta principal: Transferências podem ser feitas da conta filha para a conta principal do parceiro

​

📚 Documentação BaaS Completa

​

Endpoints Documentados

• Onboarding: Criar proposta, listar propostas, consultar status, reenviar email, upload documentos
• Accounts: Consultar saldo, consultar extrato, listar chaves PIX
• PIX: Decodificar QR, pagar QR Code, pagar via chave, consultar pagamento

​

Melhorias na Documentação

• Exemplos reais de request/response para cada endpoint
• Tabelas detalhadas de parâmetros e tipos
• Diagramas de fluxo para operações PIX
• Correção dos status de pagamento (processing, succeeded, failed)

​

📄 Suporte a Novos Tipos de Documentos

​

Novos Tipos Aceitos

​

Formatos de Upload

• multipart/form-data - Upload de arquivos binários
• application/json - Upload via Base64 (novo!)

​

🏦 APIs de Consulta de Conta

​

Endpoints

• GET /v4/i/baas/accounts/:accountId/balance - Consultar saldo disponível
• GET /v4/i/baas/accounts/:accountId/statement - Consultar extrato com filtros
• GET /v4/i/baas/accounts/:accountId/pix-keys - Listar chaves PIX da conta

​

Filtros de Extrato

​

💸 APIs PIX Out para BaaS

​

Endpoints

• POST /v4/i/baas/pix/decode-qr - Decodificar QR Code (parse local, sem consulta DICT)
• POST /v4/i/baas/pix/pay-qrcode - Pagar QR Code PIX
• POST /v4/i/baas/pix/pay-key - Pagar via chave PIX (CPF, EMAIL, PHONE, EVP)
• GET /v4/i/baas/pix/payments/:accountId/:e2eId - Consultar status do pagamento

​

Sobre o Amount

• QR Dinâmico: Valor embutido no QR, campo amount é ignorado
• QR Estático: Campo amount é obrigatório

​

✉️ Email Verification Obrigatório

​

Fluxo

1. Ao criar proposta, email de verificação é enviado automaticamente
2. Status inicial: PENDING_EMAIL_VERIFICATION
3. Cliente clica no link do email
4. Status muda para PENDING_DOCUMENTS
5. Só então pode enviar documentos KYC

​

Novos Endpoints

• POST /v4/i/baas/onboarding/:userId/resend-verification-email - Reenviar email
• GET /v4/i/baas/onboarding/all - Listar todas propostas do parceiro

​

Novo Status

​

💸 Novos Endpoints PIX OUT

​

Transferência Interna

• POST /v4/i/bank-accounts/:accountId/transfer/internal - Transferência entre contas Owem
• Processamento instantâneo
• Ideal para movimentação entre contas na estrutura BAAS

​

Pagar QR Code (EMV)

• POST /v4/i/bank-accounts/:accountId/transfer/pay - Pagamento via QR Code PIX
• Suporte a QR Codes estáticos e dinâmicos
• Validação automática de valor - QR Codes com valor definido exigem amount idêntico
• Apenas QR Codes estáticos sem valor permitem valores personalizados

​

🚀 Lançamento BAAS (Beta)

​

Novos Endpoints BAAS

• POST /v4/i/baas/onboarding/new - Criar proposta de abertura de conta
• GET /v4/i/baas/onboarding/:userId - Consultar status do onboarding (inclui dados da conta quando criada)
• POST /v4/i/baas/onboarding/:userId/documents/upload - Upload de documentos KYC

​

Funcionalidades

• Onboarding completo - Verificação KYC integrada via widget ou upload manual
• Conta bancária digital - Criação automática após aprovação KYC
• Chave PIX automática - Chave EVP (aleatória) gerada automaticamente
• Webhooks em tempo real - Notificações de status e transações
• Rate Limiting - 100 requisições/hora por API Key

​

Conformidade BACEN

• Implementação da Circular nº 3.978/2020
• Códigos padronizados para renda declarada (DINP01-05)
• Códigos padronizados para patrimônio (NWNP01-05)
• Códigos padronizados para profissão (ONP01-31)

​

Lançamento da Nova Documentação

• Documentação bilíngue: Português (pt-BR) e Inglês (EN)
• 21 endpoints documentados: Autenticação, Ledger, PIX IN, PIX OUT, Webhooks e MEDs
• Guias práticos: Receber pagamentos, enviar pagamentos, webhooks, conciliação e MEDs
• AI Tools: Integração com ChatGPT, Claude, Perplexity, Cursor e VS Code
• MCP Server: Servidor Model Context Protocol para ferramentas de IA
• Screenshots do painel: Guia visual para usar o painel administrativo

​

Webhooks Atualizados

• IPs fixos de origem: 34.134.50.53 e 35.238.101.57
• Catálogo completo de eventos
• Estrutura detalhada do payload
• Boas práticas para consumidores

​

Tipos de Chave PIX

​

Códigos de Erro BACEN/SPI

• AB03: Timeout no SPI
• AC03: Número de conta inválido
• AC06: Conta bloqueada
• AM02: Valor supera limite
• BE01: CPF/CNPJ inconsistente
• E muitos outros…