bacen / pix-api

API Pix: a API do Arranjo de Pagamentos Instantâneos Brasileiro, Pix, criado pelo Banco Central do Brasil.
https://bacen.github.io/pix-api
2.36k stars 268 forks source link

Dúvida exibição dos campos no payload gerados a partir da versão 2.0.0 para 16/11 #181

Closed monise closed 3 years ago

monise commented 3 years ago

Olá!! Gostaríamos de tirar algumas dúvidas quanto aos campos citados no [Informe Pix - 070/2020] Geração e tratamento de QR Code dinâmico (e “Pix Copia e Cola”) para cobranças com pagamento imediato.

image

Dúvida 1: Os campos valor.final, valor.juros,  valor.multa, valor.desconto, valor.permiteAlteracao e calendario.vencimento, não devem ser exibidos em payload JSON que forem gerados a partir da versão 2.0.0?

Pois de acordo com o manual Anexo II - Manual de Padroes para Iniciacao do Pix - versao 2.0.pdf os campos citados acima existem no payload JSON, conforme apresentado na seção 1.6.6. O payload JSON (página 13).

image

Como na versão 2.0.0 não existia uma especificação clara que há diferentes payloads JSON de acordo com a finalidade da cobrança (cobrança imediata e cobrança com vencimento), entendemos que não é um problema exibir os campos acima, no paylaod JSON.

Dúvida 2: Nosso entendimento acima está correto?

Dúvida 3: Os payloads que podem ser apresentados a partir de 16/11/2020 são os payloads gerados tanto seguindo a especificação da versão 2.0.0 quanto da versão 2.1.0

Dúvida 4: Os payloads JSON gerados a partir da versão 2.0.0 serão aceitos a partir de 16/11/2020?

ninrod commented 3 years ago

Boa noite @monise

Dúvida 1: Os campos valor.final, valor.juros, valor.multa, valor.desconto, valor.permiteAlteracao e calendario.vencimento, não devem ser exibidos em payload JSON que forem gerados a partir da versão 2.0.0?

Exatamente. Perceba que na API 2.0.0 esses campos não existem e que no manual de iniciação 2.0 estão marcados como "em discussão e podem mudar" (nota 36).

Pois de acordo com o manual Anexo II - Manual de Padroes para Iniciacao do Pix - versao 2.0.pdf os campos citados acima existem no payload JSON, conforme apresentado na seção 1.6.6. O payload JSON (página 13).

Como na versão 2.0.0 não existia uma especificação clara que há diferentes payloads JSON de acordo com a finalidade da cobrança (cobrança imediata e cobrança com vencimento), entendemos que não é um problema exibir os campos acima, no paylaod JSON.

Apenas observando a tabela realmente não fica claro que estes campos estavam "em dicussão e poderiam mudar"; esta observação está na nota 36.

Dúvida 2: Nosso entendimento acima está correto?

conforme expliquei acima, não.

Dúvida 3: Os payloads que podem ser apresentados a partir de 16/11/2020 são os payloads gerados tanto seguindo a especificação da versão 2.0.0 quanto da versão 2.1.0?

Sim, conforme API Pix 2.0.0 e 2.1.0.

Dúvida 4: Os payloads JSON gerados a partir da versão 2.0.0 serão aceitos a partir de 16/11/2020?

Sim @monise. E apenas para ficar muito claro, os campos:

• valor.final • valor.juros • valor.multa • valor.desconto • valor.permiteAlteracao • calendario.vencimento • calendario.recebivelAposVencimento

Não existem na versão 2.0.0 (e superior), conforme pode-se observar aqui.

monise commented 3 years ago

@ninrod Segundo a nota 36, os campos estavam em revisão no âmbito da API Pix. Se tivermos uma API proprietária para geração de QR code dinâmico via aplicativo, é considerado um erro exibir esses campos?

image

ninrod commented 3 years ago

@ninrod Segundo a nota 36, os campos estavam em revisão no âmbito da API Pix. Se tivermos uma API proprietária para geração de QR code dinâmico via aplicativo, é considerado um erro exibir esses campos?

Sim, @monise é um erro. Veja, nesse caso, não importa como o QR Dinâmico foi criado: se o app do Pagador notar campos estranhos no payload JSON, depois de acessar a "location", há grandes chances de descarte do QR e, assim, o pagamento não será realizado. O PSP pagador e o PSP recebedor não serão necessariamente os mesmos, por isso é muito importante respeitar a API Pix.

thiagolvlsantos commented 3 years ago

Dúvida aparentemente esclarecida.

Atenciosamente, Thiago Santos.