Manual de Padrões para Iniciação do Pix

Regras dos mecanismos de iniciação e integração recebedora, com obrigações condicionadas ao produto, titularidade, prazos e uso correto dos estados.

• Manual 2.10.0 integra o regulamento e detalha iniciação e API Pix; documentação OpenAPI correspondente é a tag do mesmo identificador, evitando misturar versões. BR Code trata QR apresentado pelo recebedor. Histórico e cronograma de junho de 2025 não criam novo prazo de implantação hoje. Manual de Iniciação 2.10.0, p. 1Manual de Iniciação 2.10.0, p. 6Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 118Manual de Iniciação 2.10.0, p. 119Manual de Iniciação 2.10.0, p. 123
• Estático contém chave DICT e opções limitadas; dinâmico usa location para obter cobrança; composto acrescenta location de recorrência e pode conter só recorrência. GUI é br.gov.bcb.pix. Chaves seguem DICT, incluindo CNPJ alfanumérico, celular internacional e aleatória com pontuação. Manual de Iniciação 2.10.0, p. 7Manual de Iniciação 2.10.0, p. 8Manual de Iniciação 2.10.0, p. 9
• Locations não incluem prefixo de protocolo, têm máximo de setenta e sete caracteres e distinguem cob, cobv e rec. Antes de acessar, validar caracteres, estrutura e domínio autorizado; acesso só HTTPS e campos JSON permanecem nulos até acesso e verificações positivas. Duas URLs do composto devem ter mesmo domínio completo e mesmas exigências de segurança. Manual de Iniciação 2.10.0, p. 10Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 37
• No estático, chave, infoAdicional e facilitador disputam espaço de noventa e nove caracteres do template. TxId em efeito é alfanumérico até vinte e cinco caracteres e retransmitido intacto; ausência usa marcador ***. Fss indica Saque; Troco exige dinâmico. Nome de apresentação vem do DICT, não do MerchantName do BR Code. Manual de Iniciação 2.10.0, p. 11Manual de Iniciação 2.10.0, p. 12Manual de Iniciação 2.10.0, p. 13
• Montagem de QR estático não é funcionalidade da API Pix, embora pagamentos com txid possam ser consultados. No dinâmico, valor e txid BR Code são ignorados em favor do payload da URL. QR dinâmico em integração automatizada usa API Pix, ressalvado app mobile próprio; API não retorna arquivo da imagem do QR. Manual de Iniciação 2.10.0, p. 14Manual de Iniciação 2.10.0, p. 15Manual de Iniciação 2.10.0, p. 28
• Txid de cobrança API tem vinte e seis a trinta e cinco caracteres alfanuméricos, único por CPF/CNPJ e PSP inclusive depois de cancelamento/baixa e entre cob/cobv. Recebedor normalmente o gera; delegação ao PSP só para imediata perde garantia de idempotência e exige explicação/análise. Estático tem outro modelo, com consistência de conciliação a cargo do recebedor no contexto da API. Manual de Iniciação 2.10.0, p. 21Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 48Manual de Iniciação 2.10.0, p. 52
• Cobrança com vencimento consulta DPP e município cadastral IBGE, ressalvada ausência municipal por regulação específica da conta. Sem município, recebedor assume ausência de feriados locais; sem DPP, assume vencimento se não vencida e consulta se vencida. Datas não úteis de vencimento e validade prorrogam ao útil seguinte; devedor é obrigatório nesse tipo. Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 23Manual de Iniciação 2.10.0, p. 24
• PSP recebedor calcula valor final: original menos abatimento e desconto mais juros e multa; o app do PSP pagador apresenta componentes não nulos individualmente. Parametrização distingue valor fixo/percentual, datas e dias úteis/corridos. Abatimento/desconto percentual usam bases distintas, e juros percentuais usam fator truncado em seis casas, resultado truncado em duas; multa calculada também truncada em duas. Antecipação por dias corridos usa vencimento original, mesmo não útil. Manual de Iniciação 2.10.0, p. 25Manual de Iniciação 2.10.0, p. 68Manual de Iniciação 2.10.0, p. 69Manual de Iniciação 2.10.0, p. 70Manual de Iniciação 2.10.0, p. 71Manual de Iniciação 2.10.0, p. 73Manual de Iniciação 2.10.0, p. 74Manual de Iniciação 2.10.0, p. 75Manual de Iniciação 2.10.0, p. 76Manual de Iniciação 2.10.0, p. 77Manual de Iniciação 2.10.0, p. 78Manual de Iniciação 2.10.0, p. 79Manual de Iniciação 2.10.0, p. 80Manual de Iniciação 2.10.0, p. 81
• Composto tem recorrência apenas, estático+recorrência ou dinâmico+recorrência. Dados dos payloads prevalecem sobre EMV; pagamentos compostos não permitem Saque/Troco. Copia e Cola copia integralmente a mesma sequência do QR, valendo também para composto. Manual de Iniciação 2.10.0, p. 29Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 31Manual de Iniciação 2.10.0, p. 38
• Serviço de iniciação transmite campos mínimos segundo MANU, DICT, INIC, QRES, QRDN ou AUTO; EndToEndId é gerado pelo iniciador no recorte vigente, Description é enviada se preenchida e cobv considera município informado pelo iniciador. Dados da instrução AUTO vêm da API Open Finance; essa trilha não se confunde com API Pix recebedora. Manual de Iniciação 2.10.0, p. 38Manual de Iniciação 2.10.0, p. 106
• API Pix automatiza recebedor com PSP, cria/consulta/altera/remove cobrança e verifica pagamentos, devoluções e recorrências. Cobrança é entidade diferente de Pix recebido; CONCLUÍDA é estado final da cobrança que não admite novo pagamento, sem afirmar quitação de toda obrigação subjacente. Devolução em processamento difere de devolvida ou não realizada. Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 42Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63
• Funcionalidades API são obrigatórias conforme produto/jornada da tabela, não todos os endpoints para todo participante. Webhook de Pix só informa recebimentos associados a txid e chave configurada; Rec e CobR notificam suas atualizações. Tratam integração do PSP com recebedor, sem constituir recurso próprio deste guia. Manual de Iniciação 2.10.0, p. 49Manual de Iniciação 2.10.0, p. 64Manual de Iniciação 2.10.0, p. 100
• Segurança API exige TLS pelo menos 1.2 com forward secrecy, OAuth Client Credentials e mTLS no servidor de autorização e recursos. Certificado autoassinado pelo cliente não é aceito; tokens são vinculados ao certificado e resource server verifica thumbprint. Escopos segregam permissões; client_ID vinculado a CPF/CNPJ só acessa contas daquele titular. Manual de Iniciação 2.10.0, p. 65Manual de Iniciação 2.10.0, p. 66
• Onboarding API ocorre logado, envia credenciais por canal seguro e garante rastreabilidade. API exige alta disponibilidade e confidencialidade/integridade em trânsito e repouso; logs de acesso são guardados pelo menos um ano. Webhooks usam mTLS; reutilizar certificado da API é recomendação, assim como MFA no onboarding, análise de vulnerabilidades e homologação de clientes. Manual de Iniciação 2.10.0, p. 65Manual de Iniciação 2.10.0, p. 66Manual de Iniciação 2.10.0, p. 67
• Automático distingue recorrência, permissão, autorização e cobrança; não gera QR para cada cobrança recorrente. Jornada 3 com erro em qualquer payload interrompe pagamento/autorização; jornada 4 com erro de cobrança interrompe, mas erro só da recorrência permite pagamento normal sem oferta final. Jornada 2 contém só recorrência. Manual de Iniciação 2.10.0, p. 39Manual de Iniciação 2.10.0, p. 40Manual de Iniciação 2.10.0, p. 55Manual de Iniciação 2.10.0, p. 56Manual de Iniciação 2.10.0, p. 57Manual de Iniciação 2.10.0, p. 58Manual de Iniciação 2.10.0, p. 99
• IdRec tem vinte e nove caracteres e distingue origem Pix/Open Finance e retentativas; API Pix só cria/consulta/gestiona identificadores R, não C. PSP preenche recebedor a partir de cadastro, preserva histórico de status e só usa códigos de encerramento que realmente indiquem rejeição/cancelamento. Ativação aceita jornada informada pelo PSP pagador, sem validar esse campo; inicial AGUARDANDO_DEFINICAO. Manual de Iniciação 2.10.0, p. 82Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 84
• SolicRec é exclusiva da jornada 1, com identificador SC gerado pelo PSP recebedor e dados bancários para endereçar, pois Automático não usa chaves. Guarda payload da recorrência pertinente ao pedido. Confirmação/cancelamento da recorrência cancela pedidos pendentes e comunica pagador para excluí-los; timeout de recebimento de um minuto exige cancelar e enviar pain.011. Manual de Iniciação 2.10.0, p. 46Manual de Iniciação 2.10.0, p. 84Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 89Manual de Iniciação 2.10.0, p. 96
• CobR exige autorização vigente e dados compatíveis. Conta recebedora informada em cada cobrança deve pertencer ao recebedor; PSP impede criação se não pertencer. CobR e tentativa têm status distintos, e código de rejeição pode afetar só tentativa. Histórico guarda política aplicada e tentativas originais, intradia e posteriores. Manual de Iniciação 2.10.0, p. 60Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 86Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 90Manual de Iniciação 2.10.0, p. 91Manual de Iniciação 2.10.0, p. 92Manual de Iniciação 2.10.0, p. 93Manual de Iniciação 2.10.0, p. 94
• AjusteDiaUtil é true por padrão e considera feriados do município pagador; recebedor pode optar false se tiver amparo legal para cobrar no dia não útil. Critério de vencimento em data inexistente deve constar do contrato, enquanto início de ciclo Pix usa data existente imediatamente anterior. Só uma cobrança por ciclo, salvo RIFL e NTAG. Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 98
• Após confirmação, recebedor só altera loc e nome do devedor da recorrência; data inicial e txid jornada 3 só antes. Outros parâmetros exigem cancelar e pedir nova autorização. Jornada 3 só confirma recorrência após pagamento imediato confirmado, iniciado como QRDN; pagamento feito com autorização falha exige outra jornada ou nova oferta no período seguinte. Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97
• Política após vencimento admite até três novas tentativas em dias diferentes por até sete dias corridos desde data prevista original; usuário não recusa só essa condição, mas toda recorrência. PSP rejeita pedido fora da política; pagador recebe instrução até fim da véspera. Retentativa intradia por falta de saldo é controle exclusivo pagador; erro após envio gera RIFL com novo E2E quando recebedor recebe cancelamento por falha. Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 99
• Só alteração permitida de CobR pelo recebedor é cancelamento até véspera da primeira liquidação prevista, respeitando recebimento no PSP pagador até vinte e duas horas. Para corrigir, cancelar e criar nova com novo txid dentro da janela de agendamento. Pagador não cancela individualmente retentativa após vencimento. Cancelar recorrência comunica e cancela autorização vinculada. Manual de Iniciação 2.10.0, p. 61Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 94Manual de Iniciação 2.10.0, p. 95Manual de Iniciação 2.10.0, p. 98
• Mensagens distinguem pain.009 solicitação jornada 1, pain.012 resposta/confirmacão/sincronização, pain.011 cancelamento de recorrência/pedido, pain.013 instrução, pain.014 resultado agendamento e camt.055/029 cancelamento de agenda. Pain.012 não expõe conta/agência pagadora ao recebedor via API/arquivo. Aceitar agendamento não representa liquidação. Manual de Iniciação 2.10.0, p. 101Manual de Iniciação 2.10.0, p. 107Manual de Iniciação 2.10.0, p. 108Manual de Iniciação 2.10.0, p. 109Manual de Iniciação 2.10.0, p. 110Manual de Iniciação 2.10.0, p. 111Manual de Iniciação 2.10.0, p. 112Manual de Iniciação 2.10.0, p. 113Manual de Iniciação 2.10.0, p. 114
• Cancelamento solicitado pelo recebedor só é confirmado ao seu usuário após camt.029 do pagador. Arquivo padronizado é alternativa API para Automático, baseado em CNAB com setecentas e cinquenta posições fixas por linha; leiautes de remessa/retorno e orientações são documentos complementares. Manual de Iniciação 2.10.0, p. 115Manual de Iniciação 2.10.0, p. 116Manual de Iniciação 2.10.0, p. 117
• Devolução API aponta E2E original e identificador único por E2E, pode ter várias parcelas sem ultrapassar original; no caso de uso ilustrativo, o software do recebedor consulta pela API Pix se a devolução foi liquidada. Remover/alterar cobrança comum concluída é vedado; aceitar requisição ou ter recurso EM_PROCESSAMENTO não equivale a crédito efetivado. Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63

O que esta leitura não diz. Não cria API pública do guia nem torna recomendações em obrigações; não assegura liquidação por mera criação da cobrança.

Escolhas de QR e integração, geração de cobranças e recorrências, estados, limites de alteração e confirmação de recebimentos.

• Manual 2.10.0 integra o regulamento e detalha iniciação e API Pix; documentação OpenAPI correspondente é a tag do mesmo identificador, evitando misturar versões. BR Code trata QR apresentado pelo recebedor. Histórico e cronograma de junho de 2025 não criam novo prazo de implantação hoje. Manual de Iniciação 2.10.0, p. 1Manual de Iniciação 2.10.0, p. 6Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 118Manual de Iniciação 2.10.0, p. 119Manual de Iniciação 2.10.0, p. 123
• Estático contém chave DICT e opções limitadas; dinâmico usa location para obter cobrança; composto acrescenta location de recorrência e pode conter só recorrência. GUI é br.gov.bcb.pix. Chaves seguem DICT, incluindo CNPJ alfanumérico, celular internacional e aleatória com pontuação. Manual de Iniciação 2.10.0, p. 7Manual de Iniciação 2.10.0, p. 8Manual de Iniciação 2.10.0, p. 9
• No estático, chave, infoAdicional e facilitador disputam espaço de noventa e nove caracteres do template. TxId em efeito é alfanumérico até vinte e cinco caracteres e retransmitido intacto; ausência usa marcador ***. Fss indica Saque; Troco exige dinâmico. Nome de apresentação vem do DICT, não do MerchantName do BR Code. Manual de Iniciação 2.10.0, p. 11Manual de Iniciação 2.10.0, p. 12Manual de Iniciação 2.10.0, p. 13
• Montagem de QR estático não é funcionalidade da API Pix, embora pagamentos com txid possam ser consultados. No dinâmico, valor e txid BR Code são ignorados em favor do payload da URL. QR dinâmico em integração automatizada usa API Pix, ressalvado app mobile próprio; API não retorna arquivo da imagem do QR. Manual de Iniciação 2.10.0, p. 14Manual de Iniciação 2.10.0, p. 15Manual de Iniciação 2.10.0, p. 28
• Cobrança imediata tem revisão iniciada em zero, incrementada só em alterações PUT/PATCH; recomenda-se guardar payload assinado. Timestamps são UTC e expiração ausente assume vinte e quatro horas desde criação. Devedor não é necessariamente pagador; nome é exigido quando CPF/CNPJ preenchido. Manual de Iniciação 2.10.0, p. 16Manual de Iniciação 2.10.0, p. 17Manual de Iniciação 2.10.0, p. 18
• Modalidade de alteração ausente impede editar valor. Compra, Saque e Troco têm campos e regras diferentes: Saque original zero, Troco compra positiva, retirada não se combina entre saque/troco; total não pode ser zero. Valor monetário usa duas casas decimais. Modalidade/ISPB do facilitador e domínio do agente seguem regras próprias. Manual de Iniciação 2.10.0, p. 18Manual de Iniciação 2.10.0, p. 19Manual de Iniciação 2.10.0, p. 20Manual de Iniciação 2.10.0, p. 105
• Txid de cobrança API tem vinte e seis a trinta e cinco caracteres alfanuméricos, único por CPF/CNPJ e PSP inclusive depois de cancelamento/baixa e entre cob/cobv. Recebedor normalmente o gera; delegação ao PSP só para imediata perde garantia de idempotência e exige explicação/análise. Estático tem outro modelo, com consistência de conciliação a cargo do recebedor no contexto da API. Manual de Iniciação 2.10.0, p. 21Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 48Manual de Iniciação 2.10.0, p. 52
• Cobrança com vencimento consulta DPP e município cadastral IBGE, ressalvada ausência municipal por regulação específica da conta. Sem município, recebedor assume ausência de feriados locais; sem DPP, assume vencimento se não vencida e consulta se vencida. Datas não úteis de vencimento e validade prorrogam ao útil seguinte; devedor é obrigatório nesse tipo. Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 23Manual de Iniciação 2.10.0, p. 24
• PSP recebedor calcula valor final: original menos abatimento e desconto mais juros e multa; o app do PSP pagador apresenta componentes não nulos individualmente. Parametrização distingue valor fixo/percentual, datas e dias úteis/corridos. Abatimento/desconto percentual usam bases distintas, e juros percentuais usam fator truncado em seis casas, resultado truncado em duas; multa calculada também truncada em duas. Antecipação por dias corridos usa vencimento original, mesmo não útil. Manual de Iniciação 2.10.0, p. 25Manual de Iniciação 2.10.0, p. 68Manual de Iniciação 2.10.0, p. 69Manual de Iniciação 2.10.0, p. 70Manual de Iniciação 2.10.0, p. 71Manual de Iniciação 2.10.0, p. 73Manual de Iniciação 2.10.0, p. 74Manual de Iniciação 2.10.0, p. 75Manual de Iniciação 2.10.0, p. 76Manual de Iniciação 2.10.0, p. 77Manual de Iniciação 2.10.0, p. 78Manual de Iniciação 2.10.0, p. 79Manual de Iniciação 2.10.0, p. 80Manual de Iniciação 2.10.0, p. 81
• Composto tem recorrência apenas, estático+recorrência ou dinâmico+recorrência. Dados dos payloads prevalecem sobre EMV; pagamentos compostos não permitem Saque/Troco. Copia e Cola copia integralmente a mesma sequência do QR, valendo também para composto. Manual de Iniciação 2.10.0, p. 29Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 31Manual de Iniciação 2.10.0, p. 38
• Serviço de iniciação transmite campos mínimos segundo MANU, DICT, INIC, QRES, QRDN ou AUTO; EndToEndId é gerado pelo iniciador no recorte vigente, Description é enviada se preenchida e cobv considera município informado pelo iniciador. Dados da instrução AUTO vêm da API Open Finance; essa trilha não se confunde com API Pix recebedora. Manual de Iniciação 2.10.0, p. 38Manual de Iniciação 2.10.0, p. 106
• NFC exige aparelhos com tecnologia, próximos e conectados; transporta Copia e Cola em URI e mantém confirmação e checagens do QR. Estático não resolve payload JSON. Especificação Android complementar é obrigatória no recorte, sem substituir este manual. Manual de Iniciação 2.10.0, p. 40
• API Pix automatiza recebedor com PSP, cria/consulta/altera/remove cobrança e verifica pagamentos, devoluções e recorrências. Cobrança é entidade diferente de Pix recebido; CONCLUÍDA é estado final da cobrança que não admite novo pagamento, sem afirmar quitação de toda obrigação subjacente. Devolução em processamento difere de devolvida ou não realizada. Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 42Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63
• Cardinalidades permitem vários pagamentos por cobrança e várias devoluções por Pix; locations têm uma cobrança/recorrência por vez e podem ser reutilizadas. Caso do QR dinâmico impresso confirma liquidação antes de liberar compra e desvincula cobrança para o próximo atendimento. Lote recebido com sucesso ainda está em processamento; consultar resultados individuais. Manual de Iniciação 2.10.0, p. 47Manual de Iniciação 2.10.0, p. 53Manual de Iniciação 2.10.0, p. 54
• Funcionalidades API são obrigatórias conforme produto/jornada da tabela, não todos os endpoints para todo participante. Webhook de Pix só informa recebimentos associados a txid e chave configurada; Rec e CobR notificam suas atualizações. Tratam integração do PSP com recebedor, sem constituir recurso próprio deste guia. Manual de Iniciação 2.10.0, p. 49Manual de Iniciação 2.10.0, p. 64Manual de Iniciação 2.10.0, p. 100
• Automático distingue recorrência, permissão, autorização e cobrança; não gera QR para cada cobrança recorrente. Jornada 3 com erro em qualquer payload interrompe pagamento/autorização; jornada 4 com erro de cobrança interrompe, mas erro só da recorrência permite pagamento normal sem oferta final. Jornada 2 contém só recorrência. Manual de Iniciação 2.10.0, p. 39Manual de Iniciação 2.10.0, p. 40Manual de Iniciação 2.10.0, p. 55Manual de Iniciação 2.10.0, p. 56Manual de Iniciação 2.10.0, p. 57Manual de Iniciação 2.10.0, p. 58Manual de Iniciação 2.10.0, p. 99
• IdRec tem vinte e nove caracteres e distingue origem Pix/Open Finance e retentativas; API Pix só cria/consulta/gestiona identificadores R, não C. PSP preenche recebedor a partir de cadastro, preserva histórico de status e só usa códigos de encerramento que realmente indiquem rejeição/cancelamento. Ativação aceita jornada informada pelo PSP pagador, sem validar esse campo; inicial AGUARDANDO_DEFINICAO. Manual de Iniciação 2.10.0, p. 82Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 84
• SolicRec é exclusiva da jornada 1, com identificador SC gerado pelo PSP recebedor e dados bancários para endereçar, pois Automático não usa chaves. Guarda payload da recorrência pertinente ao pedido. Confirmação/cancelamento da recorrência cancela pedidos pendentes e comunica pagador para excluí-los; timeout de recebimento de um minuto exige cancelar e enviar pain.011. Manual de Iniciação 2.10.0, p. 46Manual de Iniciação 2.10.0, p. 84Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 89Manual de Iniciação 2.10.0, p. 96
• CobR exige autorização vigente e dados compatíveis. Conta recebedora informada em cada cobrança deve pertencer ao recebedor; PSP impede criação se não pertencer. CobR e tentativa têm status distintos, e código de rejeição pode afetar só tentativa. Histórico guarda política aplicada e tentativas originais, intradia e posteriores. Manual de Iniciação 2.10.0, p. 60Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 86Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 90Manual de Iniciação 2.10.0, p. 91Manual de Iniciação 2.10.0, p. 92Manual de Iniciação 2.10.0, p. 93Manual de Iniciação 2.10.0, p. 94
• AjusteDiaUtil é true por padrão e considera feriados do município pagador; recebedor pode optar false se tiver amparo legal para cobrar no dia não útil. Critério de vencimento em data inexistente deve constar do contrato, enquanto início de ciclo Pix usa data existente imediatamente anterior. Só uma cobrança por ciclo, salvo RIFL e NTAG. Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 98
• Após confirmação, recebedor só altera loc e nome do devedor da recorrência; data inicial e txid jornada 3 só antes. Outros parâmetros exigem cancelar e pedir nova autorização. Jornada 3 só confirma recorrência após pagamento imediato confirmado, iniciado como QRDN; pagamento feito com autorização falha exige outra jornada ou nova oferta no período seguinte. Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97
• Política após vencimento admite até três novas tentativas em dias diferentes por até sete dias corridos desde data prevista original; usuário não recusa só essa condição, mas toda recorrência. PSP rejeita pedido fora da política; pagador recebe instrução até fim da véspera. Retentativa intradia por falta de saldo é controle exclusivo pagador; erro após envio gera RIFL com novo E2E quando recebedor recebe cancelamento por falha. Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 99
• Só alteração permitida de CobR pelo recebedor é cancelamento até véspera da primeira liquidação prevista, respeitando recebimento no PSP pagador até vinte e duas horas. Para corrigir, cancelar e criar nova com novo txid dentro da janela de agendamento. Pagador não cancela individualmente retentativa após vencimento. Cancelar recorrência comunica e cancela autorização vinculada. Manual de Iniciação 2.10.0, p. 61Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 94Manual de Iniciação 2.10.0, p. 95Manual de Iniciação 2.10.0, p. 98
• Cancelamento solicitado pelo recebedor só é confirmado ao seu usuário após camt.029 do pagador. Arquivo padronizado é alternativa API para Automático, baseado em CNAB com setecentas e cinquenta posições fixas por linha; leiautes de remessa/retorno e orientações são documentos complementares. Manual de Iniciação 2.10.0, p. 115Manual de Iniciação 2.10.0, p. 116Manual de Iniciação 2.10.0, p. 117
• Devolução API aponta E2E original e identificador único por E2E, pode ter várias parcelas sem ultrapassar original; no caso de uso ilustrativo, o software do recebedor consulta pela API Pix se a devolução foi liquidada. Remover/alterar cobrança comum concluída é vedado; aceitar requisição ou ter recurso EM_PROCESSAMENTO não equivale a crédito efetivado. Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63

O que esta leitura não diz. Não exige todos os produtos/endpoints para todo PSP; um QR lido ou cobrança agendada não comprova pagamento.

Locations e JWS, txid/idRec, mapeamentos ISO, requisitos API e separação de cobrança, tentativa, autorização e liquidação.

• Manual 2.10.0 integra o regulamento e detalha iniciação e API Pix; documentação OpenAPI correspondente é a tag do mesmo identificador, evitando misturar versões. BR Code trata QR apresentado pelo recebedor. Histórico e cronograma de junho de 2025 não criam novo prazo de implantação hoje. Manual de Iniciação 2.10.0, p. 1Manual de Iniciação 2.10.0, p. 6Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 118Manual de Iniciação 2.10.0, p. 119Manual de Iniciação 2.10.0, p. 123
• Estático contém chave DICT e opções limitadas; dinâmico usa location para obter cobrança; composto acrescenta location de recorrência e pode conter só recorrência. GUI é br.gov.bcb.pix. Chaves seguem DICT, incluindo CNPJ alfanumérico, celular internacional e aleatória com pontuação. Manual de Iniciação 2.10.0, p. 7Manual de Iniciação 2.10.0, p. 8Manual de Iniciação 2.10.0, p. 9
• Locations não incluem prefixo de protocolo, têm máximo de setenta e sete caracteres e distinguem cob, cobv e rec. Antes de acessar, validar caracteres, estrutura e domínio autorizado; acesso só HTTPS e campos JSON permanecem nulos até acesso e verificações positivas. Duas URLs do composto devem ter mesmo domínio completo e mesmas exigências de segurança. Manual de Iniciação 2.10.0, p. 10Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 37
• No estático, chave, infoAdicional e facilitador disputam espaço de noventa e nove caracteres do template. TxId em efeito é alfanumérico até vinte e cinco caracteres e retransmitido intacto; ausência usa marcador ***. Fss indica Saque; Troco exige dinâmico. Nome de apresentação vem do DICT, não do MerchantName do BR Code. Manual de Iniciação 2.10.0, p. 11Manual de Iniciação 2.10.0, p. 12Manual de Iniciação 2.10.0, p. 13
• Montagem de QR estático não é funcionalidade da API Pix, embora pagamentos com txid possam ser consultados. No dinâmico, valor e txid BR Code são ignorados em favor do payload da URL. QR dinâmico em integração automatizada usa API Pix, ressalvado app mobile próprio; API não retorna arquivo da imagem do QR. Manual de Iniciação 2.10.0, p. 14Manual de Iniciação 2.10.0, p. 15Manual de Iniciação 2.10.0, p. 28
• Cobrança imediata tem revisão iniciada em zero, incrementada só em alterações PUT/PATCH; recomenda-se guardar payload assinado. Timestamps são UTC e expiração ausente assume vinte e quatro horas desde criação. Devedor não é necessariamente pagador; nome é exigido quando CPF/CNPJ preenchido. Manual de Iniciação 2.10.0, p. 16Manual de Iniciação 2.10.0, p. 17Manual de Iniciação 2.10.0, p. 18
• Modalidade de alteração ausente impede editar valor. Compra, Saque e Troco têm campos e regras diferentes: Saque original zero, Troco compra positiva, retirada não se combina entre saque/troco; total não pode ser zero. Valor monetário usa duas casas decimais. Modalidade/ISPB do facilitador e domínio do agente seguem regras próprias. Manual de Iniciação 2.10.0, p. 18Manual de Iniciação 2.10.0, p. 19Manual de Iniciação 2.10.0, p. 20Manual de Iniciação 2.10.0, p. 105
• Txid de cobrança API tem vinte e seis a trinta e cinco caracteres alfanuméricos, único por CPF/CNPJ e PSP inclusive depois de cancelamento/baixa e entre cob/cobv. Recebedor normalmente o gera; delegação ao PSP só para imediata perde garantia de idempotência e exige explicação/análise. Estático tem outro modelo, com consistência de conciliação a cargo do recebedor no contexto da API. Manual de Iniciação 2.10.0, p. 21Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 48Manual de Iniciação 2.10.0, p. 52
• SolicitacaoPagador pede entrada livre: quem segue para RmtInf é a resposta do usuário, não o enunciado, até cento e quarenta caracteres. Adicionais presentes mostram pares nome/valor; payload JSON é assinado e só se procede ao parsing se assinatura JWS válida. Cobrança concluída/expirada/removida pode retornar HTTP de semântica adequada, a critério do PSP. Manual de Iniciação 2.10.0, p. 21Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 27Manual de Iniciação 2.10.0, p. 28Manual de Iniciação 2.10.0, p. 72
• Cobrança com vencimento consulta DPP e município cadastral IBGE, ressalvada ausência municipal por regulação específica da conta. Sem município, recebedor assume ausência de feriados locais; sem DPP, assume vencimento se não vencida e consulta se vencida. Datas não úteis de vencimento e validade prorrogam ao útil seguinte; devedor é obrigatório nesse tipo. Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 23Manual de Iniciação 2.10.0, p. 24
• PSP recebedor calcula valor final: original menos abatimento e desconto mais juros e multa; o app do PSP pagador apresenta componentes não nulos individualmente. Parametrização distingue valor fixo/percentual, datas e dias úteis/corridos. Abatimento/desconto percentual usam bases distintas, e juros percentuais usam fator truncado em seis casas, resultado truncado em duas; multa calculada também truncada em duas. Antecipação por dias corridos usa vencimento original, mesmo não útil. Manual de Iniciação 2.10.0, p. 25Manual de Iniciação 2.10.0, p. 68Manual de Iniciação 2.10.0, p. 69Manual de Iniciação 2.10.0, p. 70Manual de Iniciação 2.10.0, p. 71Manual de Iniciação 2.10.0, p. 73Manual de Iniciação 2.10.0, p. 74Manual de Iniciação 2.10.0, p. 75Manual de Iniciação 2.10.0, p. 76Manual de Iniciação 2.10.0, p. 77Manual de Iniciação 2.10.0, p. 78Manual de Iniciação 2.10.0, p. 79Manual de Iniciação 2.10.0, p. 80Manual de Iniciação 2.10.0, p. 81
• Composto tem recorrência apenas, estático+recorrência ou dinâmico+recorrência. Dados dos payloads prevalecem sobre EMV; pagamentos compostos não permitem Saque/Troco. Copia e Cola copia integralmente a mesma sequência do QR, valendo também para composto. Manual de Iniciação 2.10.0, p. 29Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 31Manual de Iniciação 2.10.0, p. 38
• Serviço de iniciação transmite campos mínimos segundo MANU, DICT, INIC, QRES, QRDN ou AUTO; EndToEndId é gerado pelo iniciador no recorte vigente, Description é enviada se preenchida e cobv considera município informado pelo iniciador. Dados da instrução AUTO vêm da API Open Finance; essa trilha não se confunde com API Pix recebedora. Manual de Iniciação 2.10.0, p. 38Manual de Iniciação 2.10.0, p. 106
• NFC exige aparelhos com tecnologia, próximos e conectados; transporta Copia e Cola em URI e mantém confirmação e checagens do QR. Estático não resolve payload JSON. Especificação Android complementar é obrigatória no recorte, sem substituir este manual. Manual de Iniciação 2.10.0, p. 40
• API Pix automatiza recebedor com PSP, cria/consulta/altera/remove cobrança e verifica pagamentos, devoluções e recorrências. Cobrança é entidade diferente de Pix recebido; CONCLUÍDA é estado final da cobrança que não admite novo pagamento, sem afirmar quitação de toda obrigação subjacente. Devolução em processamento difere de devolvida ou não realizada. Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 42Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63
• Cardinalidades permitem vários pagamentos por cobrança e várias devoluções por Pix; locations têm uma cobrança/recorrência por vez e podem ser reutilizadas. Caso do QR dinâmico impresso confirma liquidação antes de liberar compra e desvincula cobrança para o próximo atendimento. Lote recebido com sucesso ainda está em processamento; consultar resultados individuais. Manual de Iniciação 2.10.0, p. 47Manual de Iniciação 2.10.0, p. 53Manual de Iniciação 2.10.0, p. 54
• Funcionalidades API são obrigatórias conforme produto/jornada da tabela, não todos os endpoints para todo participante. Webhook de Pix só informa recebimentos associados a txid e chave configurada; Rec e CobR notificam suas atualizações. Tratam integração do PSP com recebedor, sem constituir recurso próprio deste guia. Manual de Iniciação 2.10.0, p. 49Manual de Iniciação 2.10.0, p. 64Manual de Iniciação 2.10.0, p. 100
• Segurança API exige TLS pelo menos 1.2 com forward secrecy, OAuth Client Credentials e mTLS no servidor de autorização e recursos. Certificado autoassinado pelo cliente não é aceito; tokens são vinculados ao certificado e resource server verifica thumbprint. Escopos segregam permissões; client_ID vinculado a CPF/CNPJ só acessa contas daquele titular. Manual de Iniciação 2.10.0, p. 65Manual de Iniciação 2.10.0, p. 66
• Onboarding API ocorre logado, envia credenciais por canal seguro e garante rastreabilidade. API exige alta disponibilidade e confidencialidade/integridade em trânsito e repouso; logs de acesso são guardados pelo menos um ano. Webhooks usam mTLS; reutilizar certificado da API é recomendação, assim como MFA no onboarding, análise de vulnerabilidades e homologação de clientes. Manual de Iniciação 2.10.0, p. 65Manual de Iniciação 2.10.0, p. 66Manual de Iniciação 2.10.0, p. 67
• Automático distingue recorrência, permissão, autorização e cobrança; não gera QR para cada cobrança recorrente. Jornada 3 com erro em qualquer payload interrompe pagamento/autorização; jornada 4 com erro de cobrança interrompe, mas erro só da recorrência permite pagamento normal sem oferta final. Jornada 2 contém só recorrência. Manual de Iniciação 2.10.0, p. 39Manual de Iniciação 2.10.0, p. 40Manual de Iniciação 2.10.0, p. 55Manual de Iniciação 2.10.0, p. 56Manual de Iniciação 2.10.0, p. 57Manual de Iniciação 2.10.0, p. 58Manual de Iniciação 2.10.0, p. 99
• IdRec tem vinte e nove caracteres e distingue origem Pix/Open Finance e retentativas; API Pix só cria/consulta/gestiona identificadores R, não C. PSP preenche recebedor a partir de cadastro, preserva histórico de status e só usa códigos de encerramento que realmente indiquem rejeição/cancelamento. Ativação aceita jornada informada pelo PSP pagador, sem validar esse campo; inicial AGUARDANDO_DEFINICAO. Manual de Iniciação 2.10.0, p. 82Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 84
• SolicRec é exclusiva da jornada 1, com identificador SC gerado pelo PSP recebedor e dados bancários para endereçar, pois Automático não usa chaves. Guarda payload da recorrência pertinente ao pedido. Confirmação/cancelamento da recorrência cancela pedidos pendentes e comunica pagador para excluí-los; timeout de recebimento de um minuto exige cancelar e enviar pain.011. Manual de Iniciação 2.10.0, p. 46Manual de Iniciação 2.10.0, p. 84Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 89Manual de Iniciação 2.10.0, p. 96
• CobR exige autorização vigente e dados compatíveis. Conta recebedora informada em cada cobrança deve pertencer ao recebedor; PSP impede criação se não pertencer. CobR e tentativa têm status distintos, e código de rejeição pode afetar só tentativa. Histórico guarda política aplicada e tentativas originais, intradia e posteriores. Manual de Iniciação 2.10.0, p. 60Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 86Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 90Manual de Iniciação 2.10.0, p. 91Manual de Iniciação 2.10.0, p. 92Manual de Iniciação 2.10.0, p. 93Manual de Iniciação 2.10.0, p. 94
• AjusteDiaUtil é true por padrão e considera feriados do município pagador; recebedor pode optar false se tiver amparo legal para cobrar no dia não útil. Critério de vencimento em data inexistente deve constar do contrato, enquanto início de ciclo Pix usa data existente imediatamente anterior. Só uma cobrança por ciclo, salvo RIFL e NTAG. Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 98
• Após confirmação, recebedor só altera loc e nome do devedor da recorrência; data inicial e txid jornada 3 só antes. Outros parâmetros exigem cancelar e pedir nova autorização. Jornada 3 só confirma recorrência após pagamento imediato confirmado, iniciado como QRDN; pagamento feito com autorização falha exige outra jornada ou nova oferta no período seguinte. Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97
• Política após vencimento admite até três novas tentativas em dias diferentes por até sete dias corridos desde data prevista original; usuário não recusa só essa condição, mas toda recorrência. PSP rejeita pedido fora da política; pagador recebe instrução até fim da véspera. Retentativa intradia por falta de saldo é controle exclusivo pagador; erro após envio gera RIFL com novo E2E quando recebedor recebe cancelamento por falha. Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 99
• Só alteração permitida de CobR pelo recebedor é cancelamento até véspera da primeira liquidação prevista, respeitando recebimento no PSP pagador até vinte e duas horas. Para corrigir, cancelar e criar nova com novo txid dentro da janela de agendamento. Pagador não cancela individualmente retentativa após vencimento. Cancelar recorrência comunica e cancela autorização vinculada. Manual de Iniciação 2.10.0, p. 61Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 94Manual de Iniciação 2.10.0, p. 95Manual de Iniciação 2.10.0, p. 98
• Mensagens distinguem pain.009 solicitação jornada 1, pain.012 resposta/confirmacão/sincronização, pain.011 cancelamento de recorrência/pedido, pain.013 instrução, pain.014 resultado agendamento e camt.055/029 cancelamento de agenda. Pain.012 não expõe conta/agência pagadora ao recebedor via API/arquivo. Aceitar agendamento não representa liquidação. Manual de Iniciação 2.10.0, p. 101Manual de Iniciação 2.10.0, p. 107Manual de Iniciação 2.10.0, p. 108Manual de Iniciação 2.10.0, p. 109Manual de Iniciação 2.10.0, p. 110Manual de Iniciação 2.10.0, p. 111Manual de Iniciação 2.10.0, p. 112Manual de Iniciação 2.10.0, p. 113Manual de Iniciação 2.10.0, p. 114
• Cancelamento solicitado pelo recebedor só é confirmado ao seu usuário após camt.029 do pagador. Arquivo padronizado é alternativa API para Automático, baseado em CNAB com setecentas e cinquenta posições fixas por linha; leiautes de remessa/retorno e orientações são documentos complementares. Manual de Iniciação 2.10.0, p. 115Manual de Iniciação 2.10.0, p. 116Manual de Iniciação 2.10.0, p. 117
• Devolução API aponta E2E original e identificador único por E2E, pode ter várias parcelas sem ultrapassar original; no caso de uso ilustrativo, o software do recebedor consulta pela API Pix se a devolução foi liquidada. Remover/alterar cobrança comum concluída é vedado; aceitar requisição ou ter recurso EM_PROCESSAMENTO não equivale a crédito efetivado. Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63

O que esta leitura não diz. Não substitui OpenAPI e catálogo correspondentes nem detalha leiautes externos que só referencia.

O que QR, Copia e Cola e aproximação transportam, dados de cobrança e recorrência e condições para comunicar sucesso ou falha.

• Manual 2.10.0 integra o regulamento e detalha iniciação e API Pix; documentação OpenAPI correspondente é a tag do mesmo identificador, evitando misturar versões. BR Code trata QR apresentado pelo recebedor. Histórico e cronograma de junho de 2025 não criam novo prazo de implantação hoje. Manual de Iniciação 2.10.0, p. 1Manual de Iniciação 2.10.0, p. 6Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 118Manual de Iniciação 2.10.0, p. 119Manual de Iniciação 2.10.0, p. 123
• Estático contém chave DICT e opções limitadas; dinâmico usa location para obter cobrança; composto acrescenta location de recorrência e pode conter só recorrência. GUI é br.gov.bcb.pix. Chaves seguem DICT, incluindo CNPJ alfanumérico, celular internacional e aleatória com pontuação. Manual de Iniciação 2.10.0, p. 7Manual de Iniciação 2.10.0, p. 8Manual de Iniciação 2.10.0, p. 9
• Locations não incluem prefixo de protocolo, têm máximo de setenta e sete caracteres e distinguem cob, cobv e rec. Antes de acessar, validar caracteres, estrutura e domínio autorizado; acesso só HTTPS e campos JSON permanecem nulos até acesso e verificações positivas. Duas URLs do composto devem ter mesmo domínio completo e mesmas exigências de segurança. Manual de Iniciação 2.10.0, p. 10Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 37
• No estático, chave, infoAdicional e facilitador disputam espaço de noventa e nove caracteres do template. TxId em efeito é alfanumérico até vinte e cinco caracteres e retransmitido intacto; ausência usa marcador ***. Fss indica Saque; Troco exige dinâmico. Nome de apresentação vem do DICT, não do MerchantName do BR Code. Manual de Iniciação 2.10.0, p. 11Manual de Iniciação 2.10.0, p. 12Manual de Iniciação 2.10.0, p. 13
• Montagem de QR estático não é funcionalidade da API Pix, embora pagamentos com txid possam ser consultados. No dinâmico, valor e txid BR Code são ignorados em favor do payload da URL. QR dinâmico em integração automatizada usa API Pix, ressalvado app mobile próprio; API não retorna arquivo da imagem do QR. Manual de Iniciação 2.10.0, p. 14Manual de Iniciação 2.10.0, p. 15Manual de Iniciação 2.10.0, p. 28
• Cobrança imediata tem revisão iniciada em zero, incrementada só em alterações PUT/PATCH; recomenda-se guardar payload assinado. Timestamps são UTC e expiração ausente assume vinte e quatro horas desde criação. Devedor não é necessariamente pagador; nome é exigido quando CPF/CNPJ preenchido. Manual de Iniciação 2.10.0, p. 16Manual de Iniciação 2.10.0, p. 17Manual de Iniciação 2.10.0, p. 18
• Modalidade de alteração ausente impede editar valor. Compra, Saque e Troco têm campos e regras diferentes: Saque original zero, Troco compra positiva, retirada não se combina entre saque/troco; total não pode ser zero. Valor monetário usa duas casas decimais. Modalidade/ISPB do facilitador e domínio do agente seguem regras próprias. Manual de Iniciação 2.10.0, p. 18Manual de Iniciação 2.10.0, p. 19Manual de Iniciação 2.10.0, p. 20Manual de Iniciação 2.10.0, p. 105
• SolicitacaoPagador pede entrada livre: quem segue para RmtInf é a resposta do usuário, não o enunciado, até cento e quarenta caracteres. Adicionais presentes mostram pares nome/valor; payload JSON é assinado e só se procede ao parsing se assinatura JWS válida. Cobrança concluída/expirada/removida pode retornar HTTP de semântica adequada, a critério do PSP. Manual de Iniciação 2.10.0, p. 21Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 27Manual de Iniciação 2.10.0, p. 28Manual de Iniciação 2.10.0, p. 72
• Cobrança com vencimento consulta DPP e município cadastral IBGE, ressalvada ausência municipal por regulação específica da conta. Sem município, recebedor assume ausência de feriados locais; sem DPP, assume vencimento se não vencida e consulta se vencida. Datas não úteis de vencimento e validade prorrogam ao útil seguinte; devedor é obrigatório nesse tipo. Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 23Manual de Iniciação 2.10.0, p. 24
• PSP recebedor calcula valor final: original menos abatimento e desconto mais juros e multa; o app do PSP pagador apresenta componentes não nulos individualmente. Parametrização distingue valor fixo/percentual, datas e dias úteis/corridos. Abatimento/desconto percentual usam bases distintas, e juros percentuais usam fator truncado em seis casas, resultado truncado em duas; multa calculada também truncada em duas. Antecipação por dias corridos usa vencimento original, mesmo não útil. Manual de Iniciação 2.10.0, p. 25Manual de Iniciação 2.10.0, p. 68Manual de Iniciação 2.10.0, p. 69Manual de Iniciação 2.10.0, p. 70Manual de Iniciação 2.10.0, p. 71Manual de Iniciação 2.10.0, p. 73Manual de Iniciação 2.10.0, p. 74Manual de Iniciação 2.10.0, p. 75Manual de Iniciação 2.10.0, p. 76Manual de Iniciação 2.10.0, p. 77Manual de Iniciação 2.10.0, p. 78Manual de Iniciação 2.10.0, p. 79Manual de Iniciação 2.10.0, p. 80Manual de Iniciação 2.10.0, p. 81
• Composto tem recorrência apenas, estático+recorrência ou dinâmico+recorrência. Dados dos payloads prevalecem sobre EMV; pagamentos compostos não permitem Saque/Troco. Copia e Cola copia integralmente a mesma sequência do QR, valendo também para composto. Manual de Iniciação 2.10.0, p. 29Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 31Manual de Iniciação 2.10.0, p. 38
• NFC exige aparelhos com tecnologia, próximos e conectados; transporta Copia e Cola em URI e mantém confirmação e checagens do QR. Estático não resolve payload JSON. Especificação Android complementar é obrigatória no recorte, sem substituir este manual. Manual de Iniciação 2.10.0, p. 40
• API Pix automatiza recebedor com PSP, cria/consulta/altera/remove cobrança e verifica pagamentos, devoluções e recorrências. Cobrança é entidade diferente de Pix recebido; CONCLUÍDA é estado final da cobrança que não admite novo pagamento, sem afirmar quitação de toda obrigação subjacente. Devolução em processamento difere de devolvida ou não realizada. Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 42Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63
• Cardinalidades permitem vários pagamentos por cobrança e várias devoluções por Pix; locations têm uma cobrança/recorrência por vez e podem ser reutilizadas. Caso do QR dinâmico impresso confirma liquidação antes de liberar compra e desvincula cobrança para o próximo atendimento. Lote recebido com sucesso ainda está em processamento; consultar resultados individuais. Manual de Iniciação 2.10.0, p. 47Manual de Iniciação 2.10.0, p. 53Manual de Iniciação 2.10.0, p. 54
• Onboarding API ocorre logado, envia credenciais por canal seguro e garante rastreabilidade. API exige alta disponibilidade e confidencialidade/integridade em trânsito e repouso; logs de acesso são guardados pelo menos um ano. Webhooks usam mTLS; reutilizar certificado da API é recomendação, assim como MFA no onboarding, análise de vulnerabilidades e homologação de clientes. Manual de Iniciação 2.10.0, p. 65Manual de Iniciação 2.10.0, p. 66Manual de Iniciação 2.10.0, p. 67
• Automático distingue recorrência, permissão, autorização e cobrança; não gera QR para cada cobrança recorrente. Jornada 3 com erro em qualquer payload interrompe pagamento/autorização; jornada 4 com erro de cobrança interrompe, mas erro só da recorrência permite pagamento normal sem oferta final. Jornada 2 contém só recorrência. Manual de Iniciação 2.10.0, p. 39Manual de Iniciação 2.10.0, p. 40Manual de Iniciação 2.10.0, p. 55Manual de Iniciação 2.10.0, p. 56Manual de Iniciação 2.10.0, p. 57Manual de Iniciação 2.10.0, p. 58Manual de Iniciação 2.10.0, p. 99
• SolicRec é exclusiva da jornada 1, com identificador SC gerado pelo PSP recebedor e dados bancários para endereçar, pois Automático não usa chaves. Guarda payload da recorrência pertinente ao pedido. Confirmação/cancelamento da recorrência cancela pedidos pendentes e comunica pagador para excluí-los; timeout de recebimento de um minuto exige cancelar e enviar pain.011. Manual de Iniciação 2.10.0, p. 46Manual de Iniciação 2.10.0, p. 84Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 89Manual de Iniciação 2.10.0, p. 96
• CobR exige autorização vigente e dados compatíveis. Conta recebedora informada em cada cobrança deve pertencer ao recebedor; PSP impede criação se não pertencer. CobR e tentativa têm status distintos, e código de rejeição pode afetar só tentativa. Histórico guarda política aplicada e tentativas originais, intradia e posteriores. Manual de Iniciação 2.10.0, p. 60Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 86Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 90Manual de Iniciação 2.10.0, p. 91Manual de Iniciação 2.10.0, p. 92Manual de Iniciação 2.10.0, p. 93Manual de Iniciação 2.10.0, p. 94
• AjusteDiaUtil é true por padrão e considera feriados do município pagador; recebedor pode optar false se tiver amparo legal para cobrar no dia não útil. Critério de vencimento em data inexistente deve constar do contrato, enquanto início de ciclo Pix usa data existente imediatamente anterior. Só uma cobrança por ciclo, salvo RIFL e NTAG. Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 98
• Após confirmação, recebedor só altera loc e nome do devedor da recorrência; data inicial e txid jornada 3 só antes. Outros parâmetros exigem cancelar e pedir nova autorização. Jornada 3 só confirma recorrência após pagamento imediato confirmado, iniciado como QRDN; pagamento feito com autorização falha exige outra jornada ou nova oferta no período seguinte. Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97
• Política após vencimento admite até três novas tentativas em dias diferentes por até sete dias corridos desde data prevista original; usuário não recusa só essa condição, mas toda recorrência. PSP rejeita pedido fora da política; pagador recebe instrução até fim da véspera. Retentativa intradia por falta de saldo é controle exclusivo pagador; erro após envio gera RIFL com novo E2E quando recebedor recebe cancelamento por falha. Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 99
• Só alteração permitida de CobR pelo recebedor é cancelamento até véspera da primeira liquidação prevista, respeitando recebimento no PSP pagador até vinte e duas horas. Para corrigir, cancelar e criar nova com novo txid dentro da janela de agendamento. Pagador não cancela individualmente retentativa após vencimento. Cancelar recorrência comunica e cancela autorização vinculada. Manual de Iniciação 2.10.0, p. 61Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 94Manual de Iniciação 2.10.0, p. 95Manual de Iniciação 2.10.0, p. 98
• Cancelamento solicitado pelo recebedor só é confirmado ao seu usuário após camt.029 do pagador. Arquivo padronizado é alternativa API para Automático, baseado em CNAB com setecentas e cinquenta posições fixas por linha; leiautes de remessa/retorno e orientações são documentos complementares. Manual de Iniciação 2.10.0, p. 115Manual de Iniciação 2.10.0, p. 116Manual de Iniciação 2.10.0, p. 117
• Devolução API aponta E2E original e identificador único por E2E, pode ter várias parcelas sem ultrapassar original; no caso de uso ilustrativo, o software do recebedor consulta pela API Pix se a devolução foi liquidada. Remover/alterar cobrança comum concluída é vedado; aceitar requisição ou ter recurso EM_PROCESSAMENTO não equivale a crédito efetivado. Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63

O que esta leitura não diz. Não define aqui todas as telas do manual UX nem permite chamar confirmação de agenda de pagamento liquidado.

Identificadores, estados e confirmações para investigar cobrança, recorrência, devolução e falhas de processamento.

• Manual 2.10.0 integra o regulamento e detalha iniciação e API Pix; documentação OpenAPI correspondente é a tag do mesmo identificador, evitando misturar versões. BR Code trata QR apresentado pelo recebedor. Histórico e cronograma de junho de 2025 não criam novo prazo de implantação hoje. Manual de Iniciação 2.10.0, p. 1Manual de Iniciação 2.10.0, p. 6Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 118Manual de Iniciação 2.10.0, p. 119Manual de Iniciação 2.10.0, p. 123
• Estático contém chave DICT e opções limitadas; dinâmico usa location para obter cobrança; composto acrescenta location de recorrência e pode conter só recorrência. GUI é br.gov.bcb.pix. Chaves seguem DICT, incluindo CNPJ alfanumérico, celular internacional e aleatória com pontuação. Manual de Iniciação 2.10.0, p. 7Manual de Iniciação 2.10.0, p. 8Manual de Iniciação 2.10.0, p. 9
• Locations não incluem prefixo de protocolo, têm máximo de setenta e sete caracteres e distinguem cob, cobv e rec. Antes de acessar, validar caracteres, estrutura e domínio autorizado; acesso só HTTPS e campos JSON permanecem nulos até acesso e verificações positivas. Duas URLs do composto devem ter mesmo domínio completo e mesmas exigências de segurança. Manual de Iniciação 2.10.0, p. 10Manual de Iniciação 2.10.0, p. 30Manual de Iniciação 2.10.0, p. 37
• No estático, chave, infoAdicional e facilitador disputam espaço de noventa e nove caracteres do template. TxId em efeito é alfanumérico até vinte e cinco caracteres e retransmitido intacto; ausência usa marcador ***. Fss indica Saque; Troco exige dinâmico. Nome de apresentação vem do DICT, não do MerchantName do BR Code. Manual de Iniciação 2.10.0, p. 11Manual de Iniciação 2.10.0, p. 12Manual de Iniciação 2.10.0, p. 13
• Montagem de QR estático não é funcionalidade da API Pix, embora pagamentos com txid possam ser consultados. No dinâmico, valor e txid BR Code são ignorados em favor do payload da URL. QR dinâmico em integração automatizada usa API Pix, ressalvado app mobile próprio; API não retorna arquivo da imagem do QR. Manual de Iniciação 2.10.0, p. 14Manual de Iniciação 2.10.0, p. 15Manual de Iniciação 2.10.0, p. 28
• Txid de cobrança API tem vinte e seis a trinta e cinco caracteres alfanuméricos, único por CPF/CNPJ e PSP inclusive depois de cancelamento/baixa e entre cob/cobv. Recebedor normalmente o gera; delegação ao PSP só para imediata perde garantia de idempotência e exige explicação/análise. Estático tem outro modelo, com consistência de conciliação a cargo do recebedor no contexto da API. Manual de Iniciação 2.10.0, p. 21Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 48Manual de Iniciação 2.10.0, p. 52
• Cobrança com vencimento consulta DPP e município cadastral IBGE, ressalvada ausência municipal por regulação específica da conta. Sem município, recebedor assume ausência de feriados locais; sem DPP, assume vencimento se não vencida e consulta se vencida. Datas não úteis de vencimento e validade prorrogam ao útil seguinte; devedor é obrigatório nesse tipo. Manual de Iniciação 2.10.0, p. 22Manual de Iniciação 2.10.0, p. 23Manual de Iniciação 2.10.0, p. 24
• PSP recebedor calcula valor final: original menos abatimento e desconto mais juros e multa; o app do PSP pagador apresenta componentes não nulos individualmente. Parametrização distingue valor fixo/percentual, datas e dias úteis/corridos. Abatimento/desconto percentual usam bases distintas, e juros percentuais usam fator truncado em seis casas, resultado truncado em duas; multa calculada também truncada em duas. Antecipação por dias corridos usa vencimento original, mesmo não útil. Manual de Iniciação 2.10.0, p. 25Manual de Iniciação 2.10.0, p. 68Manual de Iniciação 2.10.0, p. 69Manual de Iniciação 2.10.0, p. 70Manual de Iniciação 2.10.0, p. 71Manual de Iniciação 2.10.0, p. 73Manual de Iniciação 2.10.0, p. 74Manual de Iniciação 2.10.0, p. 75Manual de Iniciação 2.10.0, p. 76Manual de Iniciação 2.10.0, p. 77Manual de Iniciação 2.10.0, p. 78Manual de Iniciação 2.10.0, p. 79Manual de Iniciação 2.10.0, p. 80Manual de Iniciação 2.10.0, p. 81
• Serviço de iniciação transmite campos mínimos segundo MANU, DICT, INIC, QRES, QRDN ou AUTO; EndToEndId é gerado pelo iniciador no recorte vigente, Description é enviada se preenchida e cobv considera município informado pelo iniciador. Dados da instrução AUTO vêm da API Open Finance; essa trilha não se confunde com API Pix recebedora. Manual de Iniciação 2.10.0, p. 38Manual de Iniciação 2.10.0, p. 106
• API Pix automatiza recebedor com PSP, cria/consulta/altera/remove cobrança e verifica pagamentos, devoluções e recorrências. Cobrança é entidade diferente de Pix recebido; CONCLUÍDA é estado final da cobrança que não admite novo pagamento, sem afirmar quitação de toda obrigação subjacente. Devolução em processamento difere de devolvida ou não realizada. Manual de Iniciação 2.10.0, p. 41Manual de Iniciação 2.10.0, p. 42Manual de Iniciação 2.10.0, p. 43Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63
• Cardinalidades permitem vários pagamentos por cobrança e várias devoluções por Pix; locations têm uma cobrança/recorrência por vez e podem ser reutilizadas. Caso do QR dinâmico impresso confirma liquidação antes de liberar compra e desvincula cobrança para o próximo atendimento. Lote recebido com sucesso ainda está em processamento; consultar resultados individuais. Manual de Iniciação 2.10.0, p. 47Manual de Iniciação 2.10.0, p. 53Manual de Iniciação 2.10.0, p. 54
• Funcionalidades API são obrigatórias conforme produto/jornada da tabela, não todos os endpoints para todo participante. Webhook de Pix só informa recebimentos associados a txid e chave configurada; Rec e CobR notificam suas atualizações. Tratam integração do PSP com recebedor, sem constituir recurso próprio deste guia. Manual de Iniciação 2.10.0, p. 49Manual de Iniciação 2.10.0, p. 64Manual de Iniciação 2.10.0, p. 100
• Onboarding API ocorre logado, envia credenciais por canal seguro e garante rastreabilidade. API exige alta disponibilidade e confidencialidade/integridade em trânsito e repouso; logs de acesso são guardados pelo menos um ano. Webhooks usam mTLS; reutilizar certificado da API é recomendação, assim como MFA no onboarding, análise de vulnerabilidades e homologação de clientes. Manual de Iniciação 2.10.0, p. 65Manual de Iniciação 2.10.0, p. 66Manual de Iniciação 2.10.0, p. 67
• Automático distingue recorrência, permissão, autorização e cobrança; não gera QR para cada cobrança recorrente. Jornada 3 com erro em qualquer payload interrompe pagamento/autorização; jornada 4 com erro de cobrança interrompe, mas erro só da recorrência permite pagamento normal sem oferta final. Jornada 2 contém só recorrência. Manual de Iniciação 2.10.0, p. 39Manual de Iniciação 2.10.0, p. 40Manual de Iniciação 2.10.0, p. 55Manual de Iniciação 2.10.0, p. 56Manual de Iniciação 2.10.0, p. 57Manual de Iniciação 2.10.0, p. 58Manual de Iniciação 2.10.0, p. 99
• IdRec tem vinte e nove caracteres e distingue origem Pix/Open Finance e retentativas; API Pix só cria/consulta/gestiona identificadores R, não C. PSP preenche recebedor a partir de cadastro, preserva histórico de status e só usa códigos de encerramento que realmente indiquem rejeição/cancelamento. Ativação aceita jornada informada pelo PSP pagador, sem validar esse campo; inicial AGUARDANDO_DEFINICAO. Manual de Iniciação 2.10.0, p. 82Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 84
• SolicRec é exclusiva da jornada 1, com identificador SC gerado pelo PSP recebedor e dados bancários para endereçar, pois Automático não usa chaves. Guarda payload da recorrência pertinente ao pedido. Confirmação/cancelamento da recorrência cancela pedidos pendentes e comunica pagador para excluí-los; timeout de recebimento de um minuto exige cancelar e enviar pain.011. Manual de Iniciação 2.10.0, p. 46Manual de Iniciação 2.10.0, p. 84Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 89Manual de Iniciação 2.10.0, p. 96
• CobR exige autorização vigente e dados compatíveis. Conta recebedora informada em cada cobrança deve pertencer ao recebedor; PSP impede criação se não pertencer. CobR e tentativa têm status distintos, e código de rejeição pode afetar só tentativa. Histórico guarda política aplicada e tentativas originais, intradia e posteriores. Manual de Iniciação 2.10.0, p. 60Manual de Iniciação 2.10.0, p. 85Manual de Iniciação 2.10.0, p. 86Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 90Manual de Iniciação 2.10.0, p. 91Manual de Iniciação 2.10.0, p. 92Manual de Iniciação 2.10.0, p. 93Manual de Iniciação 2.10.0, p. 94
• AjusteDiaUtil é true por padrão e considera feriados do município pagador; recebedor pode optar false se tiver amparo legal para cobrar no dia não útil. Critério de vencimento em data inexistente deve constar do contrato, enquanto início de ciclo Pix usa data existente imediatamente anterior. Só uma cobrança por ciclo, salvo RIFL e NTAG. Manual de Iniciação 2.10.0, p. 87Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 98
• Após confirmação, recebedor só altera loc e nome do devedor da recorrência; data inicial e txid jornada 3 só antes. Outros parâmetros exigem cancelar e pedir nova autorização. Jornada 3 só confirma recorrência após pagamento imediato confirmado, iniciado como QRDN; pagamento feito com autorização falha exige outra jornada ou nova oferta no período seguinte. Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97
• Política após vencimento admite até três novas tentativas em dias diferentes por até sete dias corridos desde data prevista original; usuário não recusa só essa condição, mas toda recorrência. PSP rejeita pedido fora da política; pagador recebe instrução até fim da véspera. Retentativa intradia por falta de saldo é controle exclusivo pagador; erro após envio gera RIFL com novo E2E quando recebedor recebe cancelamento por falha. Manual de Iniciação 2.10.0, p. 44Manual de Iniciação 2.10.0, p. 83Manual de Iniciação 2.10.0, p. 96Manual de Iniciação 2.10.0, p. 97Manual de Iniciação 2.10.0, p. 99
• Só alteração permitida de CobR pelo recebedor é cancelamento até véspera da primeira liquidação prevista, respeitando recebimento no PSP pagador até vinte e duas horas. Para corrigir, cancelar e criar nova com novo txid dentro da janela de agendamento. Pagador não cancela individualmente retentativa após vencimento. Cancelar recorrência comunica e cancela autorização vinculada. Manual de Iniciação 2.10.0, p. 61Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 94Manual de Iniciação 2.10.0, p. 95Manual de Iniciação 2.10.0, p. 98
• Mensagens distinguem pain.009 solicitação jornada 1, pain.012 resposta/confirmacão/sincronização, pain.011 cancelamento de recorrência/pedido, pain.013 instrução, pain.014 resultado agendamento e camt.055/029 cancelamento de agenda. Pain.012 não expõe conta/agência pagadora ao recebedor via API/arquivo. Aceitar agendamento não representa liquidação. Manual de Iniciação 2.10.0, p. 101Manual de Iniciação 2.10.0, p. 107Manual de Iniciação 2.10.0, p. 108Manual de Iniciação 2.10.0, p. 109Manual de Iniciação 2.10.0, p. 110Manual de Iniciação 2.10.0, p. 111Manual de Iniciação 2.10.0, p. 112Manual de Iniciação 2.10.0, p. 113Manual de Iniciação 2.10.0, p. 114
• Cancelamento solicitado pelo recebedor só é confirmado ao seu usuário após camt.029 do pagador. Arquivo padronizado é alternativa API para Automático, baseado em CNAB com setecentas e cinquenta posições fixas por linha; leiautes de remessa/retorno e orientações são documentos complementares. Manual de Iniciação 2.10.0, p. 115Manual de Iniciação 2.10.0, p. 116Manual de Iniciação 2.10.0, p. 117
• Devolução API aponta E2E original e identificador único por E2E, pode ter várias parcelas sem ultrapassar original; no caso de uso ilustrativo, o software do recebedor consulta pela API Pix se a devolução foi liquidada. Remover/alterar cobrança comum concluída é vedado; aceitar requisição ou ter recurso EM_PROCESSAMENTO não equivale a crédito efetivado. Manual de Iniciação 2.10.0, p. 45Manual de Iniciação 2.10.0, p. 62Manual de Iniciação 2.10.0, p. 63

O que esta leitura não diz. Não presume quitação comercial pela etiqueta CONCLUÍDA nem garante sucesso por resposta de agendamento.