Pular para o conteúdo principal

Introdução ao fluxo de Devolução

Introdução​

O Banco Central do Brasil permite que, caso o Participante Indireto queira solicitar de volta para a conta um valor debitado em uma transação feita via PIX, este pode abrir uma Solicitação de Devolução.

info

Ressalta-se que apenas o Participante debitado pode abrir uma Solicitação de Devolução. Formalmente, o Participante o qual abre uma Solicitação de Devolução é chamado de requesting_participant.

EnumeradorTraduçãoDescrição
openabertoApós o processamento da criação da Solicitação de Devolução, o mesmo fica aberto no BACEN.
cancelledcanceladoO cancelamento da Solicitação de Devolução foi processado pela QI Tech e está cancelado no BACEN.
closedfechadoO fechamento da Solicitação de Devolução foi processado pela QI Tech e está fechado no BACEN.

Controle da Máquina de Estados​

Mesmo o fluxo sendo síncrono, é necesário que se conheça os possíveis status os quais uma Solicitação de Devolução pode ter. Abaixo, está descrito o que o Participante Indireto pode esperar após abrir, cancelar, completar e receber uma Solicitação de Devolução.

Participante Abre Solicitação de Devolução​

O Participante Indireto pode solicitar a abertura de devolução de duas maneiras:

  • Por erro operacional (operational_flaw).
  • Por um relato de infração já fechado e aceito (refund_request)
    •

    Após a abertura, o status da devolução será de open

    Participante Cancela Solicitação de Devolução​

    Após o Participante ter aberto uma Solicitação de Devolução, é possível realizar o cancelamento desta, caso seja solicitado.

    O Participante Indireto receberá uma resposta com o status de cancelled.

    Participante Recebe Solicitação de Devolução​

    Visto que outros Participantes podem abrir uma Solicitação de Devolução, é necessário que a outra ponta envolvida no fluxo possa saber recebê-lo, a fim de fechá-lo.

    Diferentemente do Relato de Infração, o qual há um status intermediário de acknowledged, o Participante Indireto receberá, via webhook, uma requisição informando que há uma Solicitação de Devolução com o status open.

    A diferença é de que, para esta requisição, o Participante Contestado é o Participante Indireto.

    Participante Fecha Solicitação de Devolução​

    Após a QI Tech, via webhook, informar o Participante Indireto de que há uma Solicitação de Devolução disponível, este pode fechar o relato.

    Quando o Participante Indireto realizar este fluxo, enviará a requisição de fechamento para a QI Tech e receberá um status de closed