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.32k stars 262 forks source link

[RFC] mensagem para a pessoa ao solicitar uma devolução Pix #418

Closed sibelius closed 2 years ago

sibelius commented 3 years ago

https://developers.openpix.com.br/pix#tag/Pix/paths/~1pix~1{e2eid}~1devolucao~1{id}/put

pix/{e2eid}/devolucao/{id}

image

Hoje só conseguimos informar o valor para solicitar uma devolução, diversos dos nossos clientes gostariam de poder enviar uma mensagem informando a motivação da devolução. O caso de uso mais comum para devolução Pix é quando o pagamento Pix foi realizado via chave Pix (transferencia Pix, pix estático), invés de pagar um QRCode dinâmico, o que impossibilita saber porque aquela transferencia foi realizada

Proposta

Permitir um novo campo no payload opcional mensagem que indicaria porque a devolução foi efetuada

{
   valor: "100.00",
   mensagem: "Realize o pagamento via QRCode inves de transferir para a chave Pix"
}
rubenskuhl commented 3 years ago

Mesmo para recebimento via QR-Code dinâmico, uma devolução parcial pode acontecer por falta de um produto. E aí a descrição ajudaria a identificar o motivo "Devolvemos o valor relativo ao produto ABCXYZ pq não será possível enviá-lo".

ninrod commented 3 years ago

@sibelius , sugestão é pertinente. Levarei ao time para discussão. Em um primeiro momento, penso que não é tão simples de implementar porque tem que desenhar a UX desse fluxo e verificar se temos espaço nas mensagens PACS para suportar mais essa informação, além de homologar com os PSPs o tratamento desse caso.

thiagolvlsantos commented 2 years ago

Demanda atendida na versão 2.6.0.

Atenciosamente, Thiago Santos