Gerada e revisada por IA (claude-opus-5-5), sem revisão humana. Confira a fonte. · UX Como funciona.
Reportar erro nesta leitura · abre seu e-mail para contato@guiapix.com.br
Iniciação Pix 2.10.0 para UX: dados e resultados da iniciação
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.