{"id":3364,"date":"2026-06-05T05:06:11","date_gmt":"2026-06-05T05:06:11","guid":{"rendered":"https:\/\/celcoin.com.br\/articles\/api-pix-liquidacao-tempo-real\/"},"modified":"2026-06-05T05:06:11","modified_gmt":"2026-06-05T05:06:11","slug":"api-pix-liquidacao-tempo-real","status":"publish","type":"post","link":"https:\/\/celcoin.com.br\/articles\/api-pix-liquidacao-tempo-real\/","title":{"rendered":"Como funciona a API para Pix com liquida\u00e7\u00e3o em tempo real?"},"content":{"rendered":"<h2>Principais li\u00e7\u00f5es deste artigo<\/h2>\n<ul>\n<li>\n<p>O fluxo completo de Pix com liquida\u00e7\u00e3o em tempo real exige integra\u00e7\u00e3o com SPI, DICT, mTLS e webhooks ass\u00edncronos para reduzir timeouts e inconsist\u00eancias.<\/p>\n<\/li>\n<li>\n<p>\u00c9 fundamental distinguir liquida\u00e7\u00e3o interna, na mesma institui\u00e7\u00e3o, de liquida\u00e7\u00e3o interbanc\u00e1ria, via SPI, pois os caminhos de c\u00f3digo e o tratamento de erros s\u00e3o diferentes.<\/p>\n<\/li>\n<li>\n<p>Webhooks com valida\u00e7\u00e3o de assinatura, idempot\u00eancia via EndToEndId e resposta em at\u00e9 5 segundos aumentam a confiabilidade da reconcilia\u00e7\u00e3o autom\u00e1tica.<\/p>\n<\/li>\n<li>\n<p>Requisitos de seguran\u00e7a como mTLS, rota\u00e7\u00e3o de certificados e conformidade com limites regulat\u00f3rios precisam de monitoramento cont\u00ednuo para evitar interrup\u00e7\u00f5es.<\/p>\n<\/li>\n<li>\n<p>Para implementar essa infraestrutura com agilidade e conformidade, <a target=\"_blank\" rel=\"noopener noreferrer nofollow\" href=\"https:\/\/www.celcoin.com.br\/?utm_source=contentmarketing&amp;utm_medium=blog&amp;utm_channel=pulse&amp;utm_campaign=GEO\">conte com a Celcoin: conhe\u00e7a a plataforma completa.<\/a><\/p>\n<\/li>\n<\/ul>\n<h2>Vis\u00e3o geral dos componentes centrais<\/h2>\n<p>O funcionamento da liquida\u00e7\u00e3o em tempo real via Pix depende de alguns componentes principais e de como eles se conectam no fluxo transacional. A seguir, veja os elementos estruturais dessa infraestrutura e o impacto de cada um no desenho da sua API.<\/p>\n<h3>Componentes SPI e DICT<\/h3>\n<p>O SPI \u00e9 a infraestrutura de liquida\u00e7\u00e3o bruta em tempo real operada pelo Banco Central. Cada transa\u00e7\u00e3o Pix \u00e9 liquidada individualmente, de forma irrevog\u00e1vel, com disponibilidade 24 horas por dia, 7 dias por semana. O DICT \u00e9 o diret\u00f3rio que mapeia chaves Pix, como CPF, CNPJ, e-mail, telefone ou chave aleat\u00f3ria, \u00e0s contas transacionais dos participantes.<\/p>\n<p>Antes de qualquer envio de ordem ao SPI, a API para Pix consulta o DICT para resolver a chave e obter os dados da institui\u00e7\u00e3o de destino, o n\u00famero da conta e o nome do titular. Participantes diretos do SPI, institui\u00e7\u00f5es homologadas pelo Banco Central, se conectam \u00e0 Rede do Sistema Financeiro Nacional, a RSFN, e enviam mensagens no padr\u00e3o ISO 20022. Participantes indiretos operam por meio de um participante direto, que assume a responsabilidade pela liquida\u00e7\u00e3o junto ao Banco Central.<\/p>\n<h3>Fluxo end-to-end de liquida\u00e7\u00e3o com timings<\/h3>\n<p>O fluxo de uma transa\u00e7\u00e3o Pix segue etapas bem definidas, com limites de tempo regulat\u00f3rios que orientam o desenho da API e dos timeouts de aplica\u00e7\u00e3o.<\/p>\n<ol>\n<li>\n<p><strong>Inicia\u00e7\u00e3o:<\/strong> o pagador autoriza a transa\u00e7\u00e3o na interface do PSP pagador. O PSP envia a mensagem de ordem de pagamento ao SPI dentro dos prazos regulat\u00f3rios aplic\u00e1veis.<\/p>\n<\/li>\n<li>\n<p><strong>Valida\u00e7\u00e3o no SPI:<\/strong> o SPI valida saldo, limites e integridade da mensagem. Em condi\u00e7\u00f5es normais, essa etapa ocorre em poucos segundos.<\/p>\n<\/li>\n<li>\n<p><strong>Liquida\u00e7\u00e3o:<\/strong> o SPI debita a conta de reservas do PSP pagador e credita a conta de reservas do PSP recebedor de forma simult\u00e2nea e irrevog\u00e1vel.<\/p>\n<\/li>\n<li>\n<p><strong>Confirma\u00e7\u00e3o ao PSP recebedor:<\/strong> o PSP recebedor recebe a confirma\u00e7\u00e3o e credita a conta do benefici\u00e1rio. O prazo regulat\u00f3rio total, da inicia\u00e7\u00e3o ao cr\u00e9dito dispon\u00edvel, \u00e9 de at\u00e9 10 segundos em condi\u00e7\u00f5es normais de opera\u00e7\u00e3o, conforme estabelecido pelo Banco Central.<\/p>\n<\/li>\n<li>\n<p><strong>Notifica\u00e7\u00e3o ao pagador:<\/strong> o PSP pagador envia o comprovante de liquida\u00e7\u00e3o ao usu\u00e1rio pagador, fechando o ciclo da transa\u00e7\u00e3o.<\/p>\n<\/li>\n<\/ol>\n<h3>Diferen\u00e7a entre liquida\u00e7\u00e3o interna e interbanc\u00e1ria<\/h3>\n<p>A liquida\u00e7\u00e3o interna ocorre quando pagador e recebedor mant\u00eam contas na mesma institui\u00e7\u00e3o. Nesse cen\u00e1rio, a transa\u00e7\u00e3o \u00e9 processada no ledger interno do PSP, sem envio ao SPI. O cr\u00e9dito costuma ocorrer em milissegundos e n\u00e3o depende da disponibilidade da RSFN.<\/p>\n<p>A liquida\u00e7\u00e3o interbanc\u00e1ria exige o ciclo completo pelo SPI descrito anteriormente, com envio de mensagem ISO 20022, valida\u00e7\u00e3o de reservas e confirma\u00e7\u00e3o bilateral. Para equipes de produto, o ponto cr\u00edtico \u00e9 manter o mesmo status de confirma\u00e7\u00e3o para o usu\u00e1rio final em ambos os casos, mesmo com caminhos de c\u00f3digo e tratamentos de erro distintos.<\/p>\n<h3>Automa\u00e7\u00e3o via webhooks para reconcilia\u00e7\u00e3o instant\u00e2nea<\/h3>\n<p>Ap\u00f3s a liquida\u00e7\u00e3o, o PSP recebedor notifica o sistema do integrador por meio de um webhook HTTP POST. A payload inclui o EndToEndId, o valor, a data e hora de liquida\u00e7\u00e3o, os dados do pagador e o status final. Para reconcilia\u00e7\u00e3o autom\u00e1tica confi\u00e1vel, o sistema receptor deve seguir uma sequ\u00eancia clara de valida\u00e7\u00f5es e garantias.<\/p>\n<p>O primeiro passo \u00e9 validar a assinatura do webhook antes de processar qualquer atualiza\u00e7\u00e3o de saldo, o que reduz o risco de eventos fraudulentos alterarem o ledger. Em seguida, o sistema precisa responder com HTTP 200 em at\u00e9 5 segundos para evitar reenvios autom\u00e1ticos, j\u00e1 que o PSP interpreta timeouts como falha de entrega.<\/p>\n<p>Como reenvios s\u00e3o esperados em caso de timeout, a aplica\u00e7\u00e3o deve implementar idempot\u00eancia usando o EndToEndId como chave de deduplica\u00e7\u00e3o. Por fim, o sistema precisa armazenar eventos em fila persistente antes de processar, o que preserva notifica\u00e7\u00f5es mesmo em caso de falhas em servi\u00e7os downstream.<\/p>\n<p>Falhas de webhook representam um dos pontos de maior risco operacional em integra\u00e7\u00f5es com Pix. Um endpoint indispon\u00edvel por alguns minutos j\u00e1 pode gerar ac\u00famulo de reenvios e inconsist\u00eancias tempor\u00e1rias entre o saldo liquidado no SPI e o saldo exibido ao usu\u00e1rio.<\/p>\n<h3>Requisitos de seguran\u00e7a e certificados<\/h3>\n<p>A autentica\u00e7\u00e3o em APIs para Pix exige mTLS, mutual TLS, em que cliente e servidor apresentam certificados X.509 para valida\u00e7\u00e3o m\u00fatua. Na pr\u00e1tica, o integrador precisa de um arquivo PFX, protegido por senha e contendo o certificado do cliente e a chave privada, al\u00e9m de um client ID para configurar o HttpClientHandler e estabelecer conex\u00f5es mTLS com os endpoints do participante direto. O padr\u00e3o <a target=\"_blank\" rel=\"noindex nofollow\" href=\"https:\/\/github.com\/codespar\/mcp-dev-latam\">mTLS \u00e9 obrigat\u00f3rio para integra\u00e7\u00f5es Pix v2 junto ao Banco Central<\/a>.<\/p>\n<p>O fluxo de autoriza\u00e7\u00e3o utiliza OAuth 2.0 com escopos espec\u00edficos por opera\u00e7\u00e3o, como cobran\u00e7a, pagamento e devolu\u00e7\u00e3o. Credenciais expostas, como client ID, caminho do PFX e senha do PFX, precisam ser revogadas imediatamente, com reemiss\u00e3o de certificados e rota\u00e7\u00e3o de client IDs, pois permitem a impersona\u00e7\u00e3o do integrador junto \u00e0 institui\u00e7\u00e3o participante.<\/p>\n<h3>Pix Autom\u00e1tico versus Pix imediato<\/h3>\n<p>O Pix imediato \u00e9 a modalidade transacional padr\u00e3o, em que o pagador autoriza cada transa\u00e7\u00e3o individualmente no momento do pagamento. O Pix Autom\u00e1tico, regulamentado pelo Banco Central e em expans\u00e3o na agenda regulat\u00f3ria de 2025-2026, permite que o pagador conceda autoriza\u00e7\u00e3o pr\u00e9via para d\u00e9bitos recorrentes, como assinaturas e mensalidades, sem autentica\u00e7\u00e3o a cada cobran\u00e7a.<\/p>\n<p>Do ponto de vista da API, o Pix Autom\u00e1tico exige a cria\u00e7\u00e3o e a gest\u00e3o de mandatos de autoriza\u00e7\u00e3o, com endpoints espec\u00edficos para cria\u00e7\u00e3o, consulta, altera\u00e7\u00e3o e cancelamento do mandato. A solu\u00e7\u00e3o tamb\u00e9m precisa de fluxos de notifica\u00e7\u00e3o para cobran\u00e7as agendadas, falhas de d\u00e9bito e cancelamentos iniciados pelo usu\u00e1rio.<\/p>\n<h2>Integra\u00e7\u00e3o via APIs e Open Finance<\/h2>\n<p>A integra\u00e7\u00e3o de APIs para Pix em plataformas de Open Finance segue padr\u00f5es definidos pelo Banco Central para inicia\u00e7\u00e3o de pagamentos. O consentimento do usu\u00e1rio ocorre em um fluxo OAuth com redirecionamento, e a inicia\u00e7\u00e3o da transa\u00e7\u00e3o acontece por chamada autenticada com mTLS ao endpoint do PSP detentor da conta.<\/p>\n<p>Para ERPs e varejistas, esse modelo permite automatizar pagamentos a fornecedores e recebimentos de clientes diretamente no fluxo de gest\u00e3o, sem redirecionamento manual para aplicativos banc\u00e1rios. A preven\u00e7\u00e3o a fraudes nesse contexto depende da valida\u00e7\u00e3o cruzada entre os dados do DICT e os dados informados pelo pagador, da an\u00e1lise de comportamento transacional em tempo real e do monitoramento de limites por canal e hor\u00e1rio, em linha com as <a target=\"_blank\" rel=\"noindex nofollow\" href=\"https:\/\/lefosse.com\/newsletter\/novas-regras-do-banco-central-reforcam-seguranca-do-pix-e-prudencia-no-sistema-financeiro-marco-2026\">novas regras de seguran\u00e7a do Banco Central publicadas em mar\u00e7o de 2026<\/a>.<\/p>\n<p><a target=\"_blank\" rel=\"noopener noreferrer nofollow\" href=\"https:\/\/www.celcoin.com.br\/?utm_source=contentmarketing&amp;utm_medium=blog&amp;utm_channel=pulse&amp;utm_campaign=GEO\"><strong>Integre sua plataforma ao ecossistema Pix com a infraestrutura da Celcoin.<\/strong><\/a><\/p>\n<h2>Erros comuns e pontos de aten\u00e7\u00e3o<\/h2>\n<p>Mesmo com a infraestrutura correta e as integra\u00e7\u00f5es bem implementadas, alguns erros recorrentes podem comprometer a estabilidade do sistema. Conhecer esses pontos de aten\u00e7\u00e3o ajuda a antecipar falhas e a definir m\u00e9tricas de monitoramento mais eficientes.<\/p>\n<p><strong>Timeouts no SPI:<\/strong> o SPI pode rejeitar mensagens enviadas fora da janela de 10 segundos. O sistema deve implementar retry com backoff exponencial e verificar o status da transa\u00e7\u00e3o via endpoint de consulta antes de reenviar, para reduzir o risco de duplicidade.<\/p>\n<p>Essa estrat\u00e9gia de retry depende de um identificador \u00fanico bem gerenciado. <strong>Falhas de idempot\u00eancia<\/strong> ocorrem quando o sistema usa o mesmo EndToEndId em duas requisi\u00e7\u00f5es distintas, o que causa rejei\u00e7\u00e3o pela infraestrutura. Cada transa\u00e7\u00e3o precisa gerar um identificador \u00fanico no formato UUID v4, conforme especifica\u00e7\u00e3o do Banco Central.<\/p>\n<p><strong>Erros de webhook:<\/strong> os cen\u00e1rios mais frequentes incluem endpoint indispon\u00edvel, com respostas HTTP 5xx, timeout na resposta acima de 5 segundos e payload malformada por incompatibilidade de vers\u00e3o. O sistema deve registrar todos os eventos recebidos com timestamp e status de processamento para auditoria e reprocessamento.<\/p>\n<p><strong>Certificados expirados:<\/strong> certificados mTLS t\u00eam validade definida. A expira\u00e7\u00e3o sem renova\u00e7\u00e3o pr\u00e9via interrompe todas as chamadas autenticadas. O monitoramento da data de expira\u00e7\u00e3o precisa ser automatizado, com alertas emitidos com pelo menos 30 dias de anteced\u00eancia.<\/p>\n<p><strong>Conformidade com limites regulat\u00f3rios:<\/strong> o Banco Central define limites por tipo de transa\u00e7\u00e3o, canal e hor\u00e1rio. As APIs devem consultar e respeitar esses limites de forma din\u00e2mica, j\u00e1 que altera\u00e7\u00f5es regulat\u00f3rias podem ocorrer sem comunica\u00e7\u00e3o imediata \u00e0s equipes de desenvolvimento.<\/p>\n<h2>Crit\u00e9rios de sucesso<\/h2>\n<p>Uma integra\u00e7\u00e3o de API para Pix com liquida\u00e7\u00e3o em tempo real atinge maturidade quando mant\u00e9m indicadores operacionais e regulat\u00f3rios em patamares est\u00e1veis. Esses crit\u00e9rios orientam o desenho de SLOs e SLAs internos.<\/p>\n<ul>\n<li>\n<p><strong>Taxa de sucesso de liquida\u00e7\u00e3o acima de 99,5%<\/strong> em janelas de 24 horas, incluindo fins de semana e feriados.<\/p>\n<\/li>\n<li>\n<p><strong>Lat\u00eancia de confirma\u00e7\u00e3o ao usu\u00e1rio abaixo de 10 segundos<\/strong> em pelo menos 99% das transa\u00e7\u00f5es interbanc\u00e1rias.<\/p>\n<\/li>\n<li>\n<p><strong>Taxa de processamento de webhooks acima de 99,9%<\/strong>, com reprocessamento autom\u00e1tico de falhas em menos de 60 segundos.<\/p>\n<\/li>\n<li>\n<p><strong>Zero duplicidade transacional<\/strong>, com controle de idempot\u00eancia no n\u00edvel da aplica\u00e7\u00e3o e da infraestrutura.<\/p>\n<\/li>\n<li>\n<p><strong>Conformidade regulat\u00f3ria cont\u00ednua<\/strong>, com relat\u00f3rios autom\u00e1ticos enviados ao Banco Central dentro dos prazos definidos.<\/p>\n<\/li>\n<\/ul>\n<p>Atingir esses indicadores exige uma infraestrutura robusta e especializada. Construir essa capacidade internamente demanda meses de desenvolvimento, al\u00e9m de manuten\u00e7\u00e3o cont\u00ednua de conformidade regulat\u00f3ria.<\/p>\n<h2>A Celcoin como infraestrutura para essa opera\u00e7\u00e3o<\/h2>\n<p>A Celcoin opera como participante direta no Pix e oferece uma plataforma full stack que abstrai a complexidade t\u00e9cnica e regulat\u00f3ria para fintechs, bancos digitais, ERPs e varejistas. A solu\u00e7\u00e3o cobre desde o modelo baas at\u00e9 o Core Banking com licen\u00e7a pr\u00f3pria e atende mais de 6 mil clientes, com mais de R$ 30 bilh\u00f5es em transa\u00e7\u00f5es mensais.<\/p>\n<table style=\"width: 799px\">\n<colgroup>\n<col style=\"width: 367px\">\n<col style=\"width: 432px\"><\/colgroup>\n<tbody>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Funcionalidade da Celcoin<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Benef\u00edcio para sua empresa<\/strong><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>APIs Modulares<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Integra\u00e7\u00f5es mais r\u00e1pidas, com redu\u00e7\u00e3o de custos e prazos de desenvolvimento.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Experi\u00eancia e suporte ao desenvolvedor<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Documenta\u00e7\u00e3o, SDKs e sandboxes reduzem ciclos de integra\u00e7\u00e3o e esfor\u00e7o de engenharia.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Capacidade de lan\u00e7amento r\u00e1pido<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>M\u00f3dulos pr\u00e9-constru\u00eddos e entrega via SaaS aceleram lan\u00e7amentos e antecipam gera\u00e7\u00e3o de receita.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Distribui\u00e7\u00e3o white-label e embutida (embedded)<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Suporte a produtos financeiros com marca pr\u00f3pria em diferentes jornadas.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Escalabilidade com confiabilidade<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Solu\u00e7\u00e3o com alta disponibilidade e escal\u00e1vel na nuvem mant\u00e9m servi\u00e7os est\u00e1veis mesmo em altos volumes.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Cobertura de diversas possibilidades de pagamentos, incluindo cr\u00e9dito<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Oferecer pagamentos e emiss\u00e3o de cr\u00e9dito aumenta convers\u00e3o, ARPU e fideliza\u00e7\u00e3o.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Acesso a dados e personaliza\u00e7\u00e3o<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Dados e an\u00e1lises via Open Finance permitem ofertas personalizadas, com impacto em convers\u00e3o e reten\u00e7\u00e3o.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Compliance e conformidade como princ\u00edpio<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>KYC, AML e relat\u00f3rios integrados reduzem risco regulat\u00f3rio e encurtam ciclos de vendas.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>Preven\u00e7\u00e3o de fraude e controles de risco<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Monitoramento baseado em IA e autentica\u00e7\u00e3o robusta reduzem estornos, perdas e exposi\u00e7\u00e3o regulat\u00f3ria.<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td colspan=\"1\" rowspan=\"1\">\n<p><strong>For\u00e7a do ecossistema de parceiros da Celcoin<\/strong><\/p>\n<\/td>\n<td colspan=\"1\" rowspan=\"1\">\n<p>Parcerias e integra\u00e7\u00f5es com bancos, redes e fintechs ampliam cobertura e velocidade de entrada no mercado.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Pr\u00f3ximos passos<\/h2>\n<p>Ap\u00f3s estabilizar a integra\u00e7\u00e3o b\u00e1sica, as equipes de produto podem evoluir para funcionalidades que aumentam automa\u00e7\u00e3o, visibilidade e recorr\u00eancia de receita.<\/p>\n<ul>\n<li>\n<p><strong>Pix Autom\u00e1tico:<\/strong> implementa\u00e7\u00e3o de mandatos para cobran\u00e7as recorrentes, com gest\u00e3o de ciclo de vida de autoriza\u00e7\u00f5es e tratamento de falhas de d\u00e9bito.<\/p>\n<\/li>\n<li>\n<p><strong>Monitoramento em tempo real:<\/strong> dashboards de lat\u00eancia, taxa de sucesso e volume transacional integrados ao sistema de observabilidade da plataforma.<\/p>\n<\/li>\n<li>\n<p><strong>Reconcilia\u00e7\u00e3o automatizada:<\/strong> pipelines que cruzam eventos de webhook com registros do ledger interno em tempo real, reduzindo processos manuais de fechamento.<\/p>\n<\/li>\n<li>\n<p><strong>Expans\u00e3o para Open Finance:<\/strong> uso da infraestrutura de inicia\u00e7\u00e3o de pagamentos para automatizar fluxos de pagamento a fornecedores e recebimentos de clientes em ERPs e plataformas de varejo.<\/p>\n<\/li>\n<\/ul>\n<p><a target=\"_blank\" rel=\"noopener noreferrer nofollow\" href=\"https:\/\/www.celcoin.com.br\/?utm_source=contentmarketing&amp;utm_medium=blog&amp;utm_channel=pulse&amp;utm_campaign=GEO\"><strong>Acelere sua roadmap de pagamentos com as APIs modulares da Celcoin.<\/strong><\/a><\/p>\n<h2>Perguntas frequentes<\/h2>\n<h3>Qual \u00e9 o prazo m\u00e1ximo regulat\u00f3rio para liquida\u00e7\u00e3o de um Pix interbanc\u00e1rio?<\/h3>\n<p>Conforme detalhado na se\u00e7\u00e3o sobre fluxo de liquida\u00e7\u00e3o, o Banco Central estabelece prazo de at\u00e9 10 segundos em condi\u00e7\u00f5es normais. Esse per\u00edodo abrange a valida\u00e7\u00e3o no SPI, a liquida\u00e7\u00e3o nas contas de reservas dos participantes e o cr\u00e9dito na conta do recebedor pelo PSP de destino.<\/p>\n<h3>O que \u00e9 mTLS e por que ele \u00e9 obrigat\u00f3rio para APIs para Pix?<\/h3>\n<p>mTLS, mutual TLS, \u00e9 um protocolo de autentica\u00e7\u00e3o m\u00fatua em que cliente e servidor apresentam certificados digitais X.509 para valida\u00e7\u00e3o antes de estabelecer a conex\u00e3o. No contexto de APIs para Pix, o Banco Central exige mTLS para garantir que apenas participantes homologados e integradores autorizados possam enviar ordens de pagamento ao SPI.<\/p>\n<p>Na pr\u00e1tica, o integrador precisa de um arquivo PFX, que cont\u00e9m o certificado do cliente e a chave privada, e de um client ID fornecido pelo participante direto. A aus\u00eancia de mTLS ou o uso de certificados inv\u00e1lidos resulta em rejei\u00e7\u00e3o imediata da conex\u00e3o, sem processamento da transa\u00e7\u00e3o.<\/p>\n<h3>Como funciona a idempot\u00eancia em APIs para Pix e por que ela \u00e9 cr\u00edtica?<\/h3>\n<p>Idempot\u00eancia garante que m\u00faltiplas chamadas com o mesmo identificador de transa\u00e7\u00e3o produzam exatamente o mesmo resultado, sem duplicidade de d\u00e9bito ou cr\u00e9dito. Em APIs para Pix, o EndToEndId, um UUID v4 gerado pelo PSP pagador, atua como chave de idempot\u00eancia.<\/p>\n<p>Se uma requisi\u00e7\u00e3o de pagamento n\u00e3o receber resposta dentro do timeout configurado, o sistema pode reenviar a mesma mensagem com o mesmo EndToEndId. A infraestrutura do SPI e do PSP recebedor reconhece o identificador j\u00e1 processado e retorna o status da transa\u00e7\u00e3o original sem gerar novo d\u00e9bito. Sistemas que n\u00e3o implementam idempot\u00eancia corretamente podem causar cobran\u00e7as duplicadas, com impacto direto na experi\u00eancia do usu\u00e1rio e em obriga\u00e7\u00f5es de devolu\u00e7\u00e3o.<\/p>\n<h3>Qual a diferen\u00e7a pr\u00e1tica entre Pix Autom\u00e1tico e d\u00e9bito autom\u00e1tico tradicional para equipes de produto?<\/h3>\n<p>O d\u00e9bito autom\u00e1tico tradicional opera em janelas de processamento em lote, com liquida\u00e7\u00e3o em D+1 ou D+2, e exige cadastro pr\u00e9vio em formul\u00e1rios f\u00edsicos ou digitais com valida\u00e7\u00e3o manual. O Pix Autom\u00e1tico opera com liquida\u00e7\u00e3o em tempo real via SPI, com mandatos de autoriza\u00e7\u00e3o criados e gerenciados via API e notifica\u00e7\u00f5es de status entregues por webhook.<\/p>\n<p>Para equipes de produto, isso significa incluir endpoints de cria\u00e7\u00e3o de mandato, fluxo de consentimento do usu\u00e1rio alinhado aos padr\u00f5es do Banco Central, l\u00f3gica de retry para cobran\u00e7as recusadas e gest\u00e3o de cancelamento de autoriza\u00e7\u00e3o pelo pagador. A agenda regulat\u00f3ria do Banco Central para 2025-2026 prev\u00ea expans\u00e3o das funcionalidades e dos casos de uso do Pix Autom\u00e1tico, o que torna essa modalidade relevante para plataformas de assinatura, ERPs e marketplaces.<\/p>\n<h3>Como garantir a conformidade regulat\u00f3ria cont\u00ednua ap\u00f3s a integra\u00e7\u00e3o inicial?<\/h3>\n<p>A conformidade regulat\u00f3ria em integra\u00e7\u00f5es com Pix continua ap\u00f3s o go-live. O Banco Central publica atualiza\u00e7\u00f5es peri\u00f3dicas nas normas do SPI, nos requisitos de seguran\u00e7a e nas funcionalidades do DICT.<\/p>\n<p>As equipes de tecnologia precisam monitorar o portal do Banco Central para novas resolu\u00e7\u00f5es, manter um processo de renova\u00e7\u00e3o antecipada de certificados mTLS, atualizar escopos OAuth conforme novas vers\u00f5es das APIs dos participantes e garantir que relat\u00f3rios regulat\u00f3rios obrigat\u00f3rios, como DIMP e CADOCs, sejam gerados e enviados dentro dos prazos definidos.<\/p>\n<p>Plataformas de infraestrutura que automatizam esses relat\u00f3rios e mant\u00eam atualiza\u00e7\u00e3o cont\u00ednua com as normas do Banco Central reduzem o risco de n\u00e3o conformidade e o custo operacional de manuten\u00e7\u00e3o regulat\u00f3ria.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Veja como a API para Pix com liquida\u00e7\u00e3o em tempo real funciona na pr\u00e1tica: SPI, webhooks, mTLS e reconcilia\u00e7\u00e3o autom\u00e1tica. Implemente com a Celcoin.<\/p>\n","protected":false},"author":34,"featured_media":3363,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-3364","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts\/3364","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/users\/34"}],"replies":[{"embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/comments?post=3364"}],"version-history":[{"count":0,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/posts\/3364\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/media\/3363"}],"wp:attachment":[{"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/media?parent=3364"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/categories?post=3364"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/celcoin.com.br\/articles\/wp-json\/wp\/v2\/tags?post=3364"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}