API de iniciação de pagamentos: guia técnico e Open Finance

Última atualização: 15 de agosto de 2026

Principais lições deste artigo

• A integração de uma API de Iniciação de Pagamentos (ITP) exige muito mais do que conectar endpoints. É preciso gerenciar consentimentos, autenticação multifator, validação DICT e conformidade contínua com as versões da especificação do Open Finance Brasil.

• Os principais desafios operacionais incluem Dynamic Client Registration (DCR), tokens de curta duração, assinatura de payloads conforme o perfil FAPI e manutenção de um sandbox realista para evitar erros em produção.

• Os pré-requisitos regulatórios e técnicos, como autorização do BCB, certificados ICP-Brasil, infraestrutura de segurança e suporte a CIBA, são obrigatórios para operar como ITP sem custodiar recursos.

• Boas práticas como idempotência, gestão de tokens, webhooks assíncronos e circuit breaker reduzem falhas, duplicações e riscos de conformidade em ambientes de alta escala.

• Com a infraestrutura da Celcoin, fintechs, bancos digitais, ERPs e varejistas conseguem lançar e escalar serviços de iniciação de pagamentos com agilidade e conformidade regulatória. Saiba mais.

O que é a API de iniciador de pagamentos e sua função no ecossistema regulado

A API de Iniciação de Pagamentos é o conjunto de endpoints padronizados pelo Open Finance Brasil que permite a uma Instituição Iniciadora de Transação de Pagamento (ITP) disparar pagamentos, como Pix imediato, agendado ou recorrente, a partir da conta do usuário em uma instituição detentora. A ITP não detém os recursos em nenhum momento. A Resolução Conjunta nº 1/2020 define o iniciador de pagamentos como uma instituição que presta serviços de iniciação sem custodiar os valores transferidos.

O desafio operacional de integrar um iniciador de pagamentos

A complexidade começa antes do primeiro pagamento. A equipe técnica precisa implementar Dynamic Client Registration (DCR), gerenciar tokens de curta duração, orquestrar o fluxo de consentimento com escopos corretos e garantir que cada requisição e resposta seja assinada conforme o perfil de segurança FAPI do Open Finance Brasil. Erros comuns incluem payloads incompletos, tokens expirados, headers ausentes e implementações incorretas de criptografia. Essas falhas frequentemente só aparecem em produção quando não há um ambiente de sandbox adequado.

O ecossistema exige atualização permanente. A especificação v5.0.0 introduziu suporte a Pix Saque e Pix Troco. Manter conformidade sem um parceiro especializado significa alocar engenharia continuamente em tarefas regulatórias, em vez de desenvolvimento de produto.

Veja como a Celcoin cobre todos os pré-requisitos técnicos e regulatórios para você operar como ITP

Visão geral: pré-requisitos e atores envolvidos

Operar como ITP no Open Finance exige o cumprimento de pré-requisitos técnicos, regulatórios e operacionais claros.

• Autorização do Banco Central: somente instituições financeiras, instituições de pagamento e demais autorizadas pelo BCB podem participar do Open Finance.

• Certificados digitais: uso de certificados BRCAC e BRSEAL emitidos por ICP-Brasil para autenticação mTLS e assinatura de payloads JWS.

• DCR (Dynamic Client Registration): registro dinâmico de cliente junto às instituições detentoras, papel CONTA, antes de qualquer chamada de negócio.

• Infraestrutura de segurança FAPI: suporte a Pushed Authorization Requests (PAR), private_key_jwt, PKCE e criptografia RSA-OAEP com A256GCM nos ID Tokens.

• Endpoint de notificação CIBA (quando aplicável): o perfil CIBA-BR exige que o RP registre um backchannel_client_notification_endpoint que aceite conexões mTLS autenticadas com certificados BRCAC.

Os dois papéis centrais no ecossistema são CONTA, que é a instituição detentora da conta do pagador, e PAGTO, que é a instituição iniciadora do pagamento. A ITP não toca os fundos. Ela apenas cria o consentimento e dispara a instrução de pagamento para a detentora executar.

Passo a passo do fluxo de consentimento e pagamento

1. Criação do consentimento: POST /consents
   A ITP chama o endpoint de criação de consentimento usando um access_token obtido via grant_type=client_credentials com escopo payments. Nessa etapa, a detentora não deve retornar informações específicas do cliente, como saldo insuficiente ou conta bloqueada, nem realizar consultas ao DICT. Essas verificações ocorrem apenas na criação do pagamento.

2. Autenticação e autorização: FAPI Hybrid Flow ou CIBA, LoA3
   O servidor de autorização da detentora deve exigir autenticação compatível com LoA3 (urn:brasil:openbanking:loa3), definida como autenticação multifator com ao menos dois fatores distintos de conhecimento, posse ou inerência. No fluxo FAPI Hybrid Flow, o usuário é redirecionado ao app da detentora. No fluxo CIBA, a autenticação ocorre de forma desacoplada via push, SMS ou WhatsApp, sem redirecionamento obrigatório, em modalidade regulamentada pelo Banco Central.

3. Criação do pagamento: POST /pix/payments, authorization_code, validação DICT
   Com o consentimento em status AUTHORISED, a ITP obtém um access_token via grant_type=authorization_code com escopos openid e payments e chama o endpoint de criação do pagamento. Para pagamentos agendados, a detentora deve consultar a chave Pix no DICT antes da liquidação. Se a chave não estiver registrada ou os dados divergirem, o pagamento deve ser rejeitado com o motivo apropriado.

4. Confirmação, liquidação e status CONSUMED
   Após a liquidação bem-sucedida, o consentimento passa para o status CONSUMED. O servidor de autorização não deve emitir refresh_token quando o consentimento está CONSUMED. Um novo access_token deve ser obtido via client_credentials para consultas de status subsequentes. Para pagamentos imediatos, as aprovações de consentimento devem ser concluídas em até 5 minutos após a criação, sob pena de rejeição.

5. Cancelamento e tratamento de erros assíncronos
   A API define dois endpoints de cancelamento: PATCH /pix/payments/{paymentId} para cancelamento individual e PATCH /pix/payments/consents/{consentId} para cancelar todos os pagamentos pendentes de um consentimento recorrente. Motivos de rejeição assíncrona devem ser tratados com lógica de retry e notificação ao usuário.

Erros comuns, pontos de atenção e boas práticas

• Idempotência: cada requisição deve conter uma chave de idempotência única rastreada no servidor para evitar duplicação de transações em caso de timeout ou erro de rede.

• Gestão de tokens: tokens de curta duração, escopos de consentimento e comportamento de refresh devem ser modelados explicitamente.

• Limite de pagamentos recorrentes: os limites de pagamentos por consentimento recorrente devem seguir as regras do Open Finance.

• Webhooks e notificações assíncronas: para transações de longa duração, um sistema de notificação baseado em webhook deve ser usado em vez de espera síncrona.

• Circuit breaker: o padrão de circuit breaker deve ser implementado para evitar falhas em cascata quando ocorrem problemas no lado da detentora.

• Logs e mascaramento: dados sensíveis não devem aparecer em registros de log. O mascaramento é obrigatório para conformidade com a LGPD.

Critérios de sucesso e validação

Uma integração ITP bem-sucedida deve atender a métricas objetivas de estabilidade e conformidade.

• Taxa de sucesso de consentimentos aprovados acima de 95% em ambiente de produção.

• Tempo de integração reduzido por uso de sandbox com dados realistas, documentação completa e SDKs disponíveis.

• Zero retrabalho regulatório por atualização de especificação, com um parceiro que absorve as mudanças da API antes que impactem a operação.

• Aderência contínua às resoluções do BCB, incluindo validações DICT, limites de agendamento e novos motivos de rejeição da v5.0.0.

Por que a infraestrutura da Celcoin é a escolha mais adequada

A Celcoin atua como participante direta no Pix e como Iniciadora de Pagamentos no Open Finance. A empresa oferece infraestrutura full stack que cobre desde as licenças regulatórias até as APIs modulares de Open Finance. Fintechs, bancos digitais, ERPs e varejistas podem operar sob a licença da Celcoin no modelo BaaS ou integrar suas próprias licenças ao Core Banking, mantendo a mesma base tecnológica em constante atualização, sem precisar reconstruir a infraestrutura a cada nova versão da especificação.

A tabela a seguir resume as principais funcionalidades da plataforma Celcoin e o impacto direto de cada uma na operação e nos resultados financeiros da sua empresa.

Funcionalidade da Celcoin	Benefício para sua empresa
APIs modulares	Integrações mais rápidas, com redução de custos e prazos de desenvolvimento.
Experiência e suporte ao desenvolvedor	Documentação, SDKs e sandboxes que reduzem ciclos de integração e custos de engenharia.
Capacidade de lançamento rápido	Módulos pré-construídos e entrega via SaaS aceleram lançamentos, melhorando o tempo para geração de receita e competitividade.
Distribuição white-label e embutida (embedded)	Suporte a produtos financeiros com marca própria.
Escalabilidade com confiabilidade	Solução com alta disponibilidade e escalável na nuvem mantém serviços funcionando mesmo com altos volumes, protegendo sua receita com confiança.
Cobertura de diversas possibilidades de pagamentos, incluindo crédito	Oferecer pagamentos e emissão de crédito aumenta conversão, ARPU e fidelização.
Acesso a dados e personalização	Dados e análises via Open Finance permitem ofertas personalizadas, melhorando conversão e retenção.
Compliance e conformidade como princípio	KYC, AML e relatórios integrados reduzem risco regulatório e aceleram ciclos de vendas.
Prevenção de fraude e controles de risco	Monitoramento baseado em IA e autenticação robusta reduzem estornos, perdas e exposição regulatória.
Força do ecossistema de parceiros da Celcoin	Parcerias e integrações com bancos, redes e fintechs garantem melhor cobertura, recursos e velocidade de entrada no mercado.

A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes.

Explore as funcionalidades completas da plataforma Celcoin

Próximos passos: expansão, automação e evolução regulatória

Com a infraestrutura ITP operacional, o próximo horizonte inclui a adoção do Pix Automático, modalidade recorrente do Pix lançada em 16 de junho de 2025, regulamentada por resoluções do BCB como a nº 402/2024 e pela IN BCB nº 614 de maio de 2025, além da expansão para Pix Saque e Pix Troco introduzidos na v5.0.0. A automação de relatórios regulatórios, como CADOCs, CCS e DIMP, e a integração com o perfil CIBA para jornadas sem redirecionamento são os próximos passos naturais para escalar a operação com menor fricção para o usuário final.

A Celcoin absorve essas evoluções na própria plataforma. Os clientes permanecem em conformidade sem necessidade de retrabalho interno.

Perguntas frequentes

Qual é o prazo médio para integrar uma API de iniciação de pagamentos com a infraestrutura da Celcoin?

O prazo varia conforme a complexidade da estrutura existente e a disponibilidade da equipe técnica. Alguns clientes conseguem implementar a solução em uma semana. Outros, com operações mais complexas, podem levar até três meses. A Celcoin disponibiliza documentação completa, SDKs e ambiente de sandbox para reduzir os ciclos de integração e minimizar surpresas em produção.

É necessário ter licença própria de Instituição de Pagamento para usar a API de iniciador de pagamentos da Celcoin?

Não necessariamente. Como mencionado anteriormente, a Celcoin oferece tanto o modelo BaaS, com operação sob a licença da empresa, quanto a opção de integrar a própria licença de IP ao Core Banking quando a instituição estiver pronta para essa transição.

Como a Celcoin garante conformidade com as atualizações regulatórias, como a versão 5.0.0 da API de pagamentos?

A Celcoin monitora continuamente as especificações do Open Finance Brasil e as resoluções do Banco Central, incorporando as atualizações, como suporte a Pix Saque e Pix Troco, diretamente na plataforma. Os clientes não precisam alocar engenharia interna para acompanhar cada versão da especificação. A Celcoin absorve essa complexidade e entrega a conformidade como parte do serviço.

A solução da Celcoin suporta o fluxo CIBA para autenticação sem redirecionamento?

Sim. A infraestrutura de Open Finance da Celcoin é compatível com o perfil CIBA-BR, que permite autenticação desacoplada via push, SMS ou WhatsApp, sem necessidade de redirecionar o usuário ao aplicativo da instituição detentora. Esse fluxo é especialmente relevante para ERPs e varejistas que desejam oferecer uma jornada de pagamento fluida e integrada à própria interface.

Quais tipos de pagamentos Pix são suportados pela API de iniciação de pagamentos?

A API suporta Pix imediato, Pix agendado, Pix recorrente, incluindo o Pix Automático lançado em 16 de junho de 2025, Pix Saque e Pix Troco, modalidades introduzidas na versão 5.0.0 da especificação.

Conclusão

A API de Iniciação de Pagamentos no Open Finance brasileiro é um dos mecanismos mais regulados e tecnicamente exigentes do ecossistema financeiro nacional. Dominar o fluxo de consentimento, a autenticação LoA3, a validação DICT e os ciclos de atualização da especificação, como a v5.0.0, exige infraestrutura robusta, equipe especializada e um parceiro que evolua junto com o regulatório.

A Celcoin oferece uma plataforma full stack com licenças, APIs modulares, Core Banking e Open Finance integrados em um único ambiente. Essa combinação permite que fintechs, bancos digitais, ERPs e varejistas lancem e escalem serviços de iniciação de pagamentos com agilidade e conformidade.

Comece a operar serviços de iniciação de pagamentos com a infraestrutura da Celcoin