Lançamento da v5.0.0 da API de PagamentosService Desk – Atualizações no Fluxo da FVP Manual

Informe nº 889 | 06/05/2026

Lançamento da v5.0.0 da API de Pagamentos

Comunicamos que, em 05/05/2026, foi publicada a versão v5.0.0 da API de Pagamentos, a qual está disponível na área do desenvolvedor em:

Especificações de APIs > Serviços - SV > [SV] Pagamentos > [SV] API – Pagamentos > v5.0.0 - [SV] Pagamentos > Informações técnicas - [SV] Pagamentos - v5.0.0

Principais mudanças contempladas são:

Habilitação de Pix Saque e Pix Troco

Inclusão dos campos purpose (com valores WITHDRAW e CHANGE) e payloadJWS no consentimento, viabilizando o reporte do payload completo gerado pelo PSP do Recebedor com os dados do agente e do facilitador do serviço.

Adicionados o erro 422 PROPOSITO_INVALIDO e o rejectionReason PERMISSAO_INSUFICIENTE, este último aplicável quando a operação for solicitada por usuário sem plenos poderes de aprovação.

Suporte à iniciação por aproximação (NFC)

Adicionados os valores APDN (QR Code dinâmico via NFC) e APES (QR Code estático via NFC) ao enum de localInstrument, com QRDN e QRES redefinidos para representar leitura por canais que não sejam NFC.

Regras de preenchimento de proxy, qrCode e transactionIdentification foram propagadas para os novos valores, mantendo simetria com o comportamento dos QR Codes tradicionais.

Padronização alfanumérica de identificadores

Os campos ispb (debtor e creditor), cpfCnpj, cnpjInitiator, businessEntity.document.identification e endToEndId tiveram seus patterns ajustados para aceitar caracteres alfabéticos maiúsculos (ex.: ^[0-9]{8}$ → ^[0-9A-Z]{8}$), em alinhamento à evolução do arranjo Pix.

Integrações que validam estes campos no lado consumidor devem ser ajustadas para não rejeitar payloads contendo letras nas posições afetadas.

Formalização do funil de rejeição da JSR (Jornada Sem Redirecionamento)

Para consentimentos autorizados via fluxo sem redirecionamento, apenas três motivos de rejeição são cabíveis: TEMPO_EXPIRADO_AUTORIZACAO, TEMPO_EXPIRADO_CONSUMO e FALHA_INFRAESTRUTURA. Demais validações foram deslocadas para o momento do pagamento.

Adicionado o motivo AUTENTICACAO_DIVERGENTE, aplicável quando o usuário autenticado na detentora difere do usuário autenticado na iniciadora.

Adicionalmente, complementamos na Área do Desenvolvedor a página com orientações quanto ao escopo da API de pagamentos cujo objetivo é de consolidar e detalhar as formas de iniciação de pagamentos.

Informações sobre o cronograma de implementação e certificação bem como a data de go live, podem ser encontradas no Informa #812 (“Divulgação do cronograma de certificação e implementação da v5.0.0 da API Pagamentos”, divulgado em 11/11/2025).

Service Desk – Atualizações no Fluxo da FVP Manual

Informamos que no dia 13/05/2026 serão aplicadas as seguintes atualizações no fluxo de tickets da FVP Manual:

Nova classificação

Será criada a categoria FVP Manual - Testes Abertos para o direcionamento de testes desta natureza. Os tickets serão abertos exclusivamente pela AOF.

Importante: A reexecução e o encerramento dos tickets de testes abertos deverão ser realizados pela própria instituição. O fluxo dos testes restritos não sofrerá modificações.

Categoria a ser criada:

Novo campo

Será disponibilizado no formulário o campo “Ciclo”, que será preenchido pela AOF. Esse campo terá caráter informativo e tem como objetivo apoiar tanto o responsável pelo reteste quanto a instituição responsável pelo ticket, trazendo mais clareza sobre o contexto do atendimento.

Novo campo:

Nome do Campo

Ciclo

Categorias a serem atualizadas:

As informações sobre a FVP Manual estão disponíveis em FVP Manual – Área do Desenvolvedor.

Detalhes sobre os campos, parâmetros e requisições necessárias para a correta utilização das integrações estão disponíveis nos artigos da FAQ do Service Desk. Em caso de dúvidas relacionadas a essa atualização, solicitamos a abertura de um ticket por meio da plataforma.