Processar devolução Pix iniciada pelo banco recebedor
Processa uma devolução Pix iniciada pelo banco recebedor e enviada pelo sistema upstream; este endpoint não inicia a devolução. Credita ao pagador original o valor retornado, sujeito a um teto cumulativo sobre os valores retornados, deduplica pelo id ponta a ponta de retorno atribuído pelo upstream e retorna o reconhecimento de crédito do gateway de liquidação.
Autorizações
Autenticacao por token JWT Bearer. Obtenha o token no endpoint /v1/login/oauth/access_token
usando credenciais do cliente (clientId e clientSecret).
Inclua o token no header Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
O token expira apos 3600 segundos (1 hora).
Corpo
Id de retorno atribuído pelo upstream (chave de idempotência + dedup).
Id ponta a ponta do CASH_OUT original.
Id da requisição upstream (GUID), ecoado no reconhecimento.
Valor de retorno em reais (um número JSON).
Código de motivo de retorno (eRefundCode).
Informação inter-clientes em texto livre.
Motivo de retorno em texto livre.
Resposta
OK
carimbo de data/hora de crédito do gateway de liquidação (ISO-8601).
Data/hora da validação (ISO-8601).
id de crédito do gateway de liquidação.
Id da requisição upstream ecoado.
Código de motivo (em um retorno rejeitado).
Complemento do motivo.
Resultado da validação (0=Inválido, 1=Válido).

