A jornada de devolução é muito parecida com a de pagamento, tendo como diferença o início da jornada. Nela, o cliente final, partindo de um PIX recebido, solicita à sua instituição o envio de uma devolução (DEV1).

Um PIX recebido poderá ser devolvido dentro de 90 dias da data do recebimento, por iniciativa do cliente recebedor.

Poderão ser realizadas diversas transações de devolução relacionadas a um mesmo recebimento, desde que a soma dessas devoluções seja menor ou igual ao recebimento inicial.

Solicitação de devolução

Nesta funcionalidade, possibilitamos o envio de uma devolução.

Solicitamos os campos:

Campo	Descrição	Formato	Obrigatório
endToEndId	Identificador do pagamento que originou a devolução	string	Sim
idExterno	Identificador da transação informado pelo participante indireto ao solicitar a devolução	string	Sim
valor	Valor total ou parcial da devolução	double	Sim
motivo	Mensagem destinada ao recebedor	string	Não
código	Código do motivo da devolução que será enviado na PACS004, conforme tabela Motivos de devolução	string	Sim
prioridadeTransacao	Prioridade de envio da transação, conforme tabela Tipo Prioridade	string	Sim

Resposta:

Campo	Descrição	Formato	Nullable
solicitadoEmUtc	Data e hora em que a devolução foi solicitado pelo recebedor	date-time	Não
returnId	Identificador da transação de devolução	string	Sim
endToEndId	Identificador do pagamento que originou a devolução	string	Sim
idExterno	Identificador da transação informado pelo participante indireto ao solicitar a devolução	string	Sim

Solicitar uma devolução

Consulta de devoluções

Por meio das funcionalidades abaixo, a busca por uma lista ou uma transação de devolução específica é disponibilizada.

Lista de devoluções

Nesta funcionalidade permitimos a obtenção de uma lista de devoluções vinculadas a um recebimento.

Solicitamos os campos:

Campo	Descrição	Formato	Obrigatório
endToEndId	Identificador da transação que originou a devolução	string	Sim
status	Status da devolução, caso deseje recuperar um status específico. Conforme tabela Status da devolução	string	Não

Resposta:

Campo	Descrição	Formato	Nullable
idExterno	Identificador da transação informado pelo participante indireto ao solicitar a devolução	string	Sim
endToEndId	Identificador do recebimento que originou a devolução	string	Sim
returnId	Identificador da transação de devolução	string	Sim
valor	Valor da transação	double	Não
status	Status da devolução, conforme tabela Status da devolução	string	Não
motivo	Mensagem destinada ao recebedor	string	Sim
tipo	Tipo da devolução, conforme tabela Tipo de devolução	string	Não
codigo	Código do motivo da devolução que será enviado na PACS004, conforme tabela Motivos de devolução	string	Não
prioridadeTransacao	Prioridade de envio da transação, conforme tabela Tipo Prioridade	string	Não
erroDescricao	Descrição do erro na devolução	string	Sim
motivoRejeicao	Código e descrição do motivo da rejeição da devolução que foi informado pelo BACEN na PACS002	object	Sim

Listar devoluções

Consulta uma devolução específica

Nesta funcionalidade permitimos consultar a uma devolução específica.

Solicitamos os campos:

Campo	Descrição	Formato	Obrigatório
endToEndId	Identificador do pagamento que originou a devolução	string	Sim
returnId	Identificador da transação de devolução Pix	string	Sim

Resposta:

Campo	Descrição	Formato	Nullable
idExterno	Identificador da transação informado pelo participante indireto ao solicitar a devolução	string	Sim
endToEndId	Identificador do pagamento que originou a devolução	string	Sim
returnId	Identificador da transação de devolução	string	Sim
valor	Valor da transação	double	Não
status	Status da devolução, conforme tabela Status da devolução	string	Não
motivo	Mensagem destinada ao recebedor	string	Sim
tipo	Tipo da devolução, conforme tabela Tipo de devolução	string	Não
codigo	Código do motivo da devolução que será enviado na PACS004, conforme tabela Motivos de devolução	string	Não
prioridadeTransacao	Prioridade de envio da transação, conforme tabela Tipo Prioridade	string	Não
erroDescricao	Descrição do erro na transação de devolução	string	Sim
motivoRejeicao	Código e descrição do motivo da rejeição da devolução que foi informado pelo BACEN na PACS002	object	Sim

Obter devolução

Notificação de devoluções

Nesta etapa o participante indireto é notificado da finalização do processo de devolução, através da notificação cadastrada.

Acesse a página Webhooks para participantes indiretos para orientações de como cadastrar as notificações.