Fechar Solicitação de Devolução

O Participante Indireto pode fechar uma solicitação de devolução, se este (Participante) estiver como Participante Contestado.

Para o fechamento, o status deve ser de OPEN.

IMPORTANTE

O Banco Central do Brasil define que, dentro de um período de 1 dia do recebimento da Solicitação de Devolução pelo Participante Indireto, a Devolução precisa ser fechada.

Caso haja atraso por parte do Participante Indireto, a QI Tech irá fechar a Solicitação de Devolução, com o status de totally_accepted, a fim de que a instituição não seja penalizada pelo Banco Central do Brasil.

Request

ENDPOINT

/pix/refund_request/REFUND_REQUEST_KEY

MÉTODO

PATCH

Request Body

{
    "request_control_key":"xpjae07e-1dc7-4df0-8472-233624706e08",
    "refund_request_status": "closed",
    "analysis_result": "totally_accepted",
    "analysis_details": "Valor bloqueado. Para mais informações, contatar central antifraude em 11 3000-45012, informando ID 0000.",
    "refund_transfer_key": "cdcf0d25-08a1-46e3-902a-6d7ca75e6c48"
}

Path Params

Campo	Tipo	Descrição	Caracteres
refund_request_key *	string	UUID4 da devolução já criada.	36

Body Params

Campo	Tipo	Descrição	Caracteres
request_control_key *	uuidv4	UUID4 para fins de consulta sobre a requisição feita.	36
request_request_status *	enum	status	Enumeradores refund_request_status
analysis_result *	enum	Resultado da análise	Enumeradores analysis_result
analysis_details	string	Comentário sobre a análise	<= 2000
refund_transfer_key	string	UUID4 da transação de devolução enviada pela rota de "reversal". Deve ser utilizado quando o "analysis_result" é de aceite.	36
reject_reason	enum	Razão da rejeição da devolução. Deve ser utilizado quando o campo 'analysis_result' é 'rejected'.	Enumeradores reject_reason

Response

STATUS

200

Response Body - Recusa

{
  "refund_request_key": "2e42116f-4bdb-4f07-931f-c4dc7a78ed99",
  "pix_transfer_key": "d5856a5f-378f-43ed-818b-df33b9fae703",
  "end_to_end_id": "E60701190202406281828JCBxFsqssCf",
  "requested_amount": 10,
  "refund_request_status": "closed",
  "refund_request_type": "operational_flaw",
  "infraction_report_key": null,
  "refund_request_details": "Foi identificada uma fraude na transação.",
  "requesting_participant": "99999999",
  "contested_participant": "73856642",
  "analysis_result": "rejected",
  "analysis_details": "Conta sem saldo.",
  "reject_reason": "no_balance",
  "refund_transfer_key": null,
  "refunded_amount": 0.00,
  "refund_request_direction": "incoming",
  "created_at": "2024-07-01T15:46:18Z"
}

Response Body - Aceite

{
  "refund_request_key": "2e42116f-4bdb-4f07-931f-c4dc7a78ed99",
  "pix_transfer_key": "d5856a5f-378f-43ed-818b-df33b9fae703",
  "end_to_end_id": "E60701190202406281828JCBxFsqssCf",
  "requested_amount": 10,
  "refund_request_status": "closed",
  "refund_request_type": "operational_flaw",
  "infraction_report_key": null,
  "refund_request_details": "Foi identificada uma fraude na transação.",
  "requesting_participant": "99999999",
  "contested_participant": "73856642",
  "analysis_result": "totally_accepted",
  "analysis_details": "Valor devolvido.",
  "reject_reason": null,
  "refund_transfer_key": "ab1189d8-5a87-4e5b-b49c-d05776bd8efe",
  "refunded_amount": 10.00,
  "refund_request_direction": "incoming",
  "created_at": "2024-07-01T15:46:18Z"
}

Body Params

Campo	Tipo	Descrição	Caracteres
pix_transfer_key*	string	Identificador único da transação PIX.	36
refund_request_key*	string	Identificador único da devolução.	36
infraction_report_key*	string	Identificador único da infração relacionada à devolução. Somente quando o tipo for FRAUDE	36
refund_request_type	enum	Tipo de solicitação de devolução.	Enumeradores refund_request_type
requested_amount*	float	Valor da devolução	-
refund_request_status*	enum	Status .	Enumeradores refund_request_status
contested_participant*	string	ISPB do Participante Creditado (Contestado).	8
requesting_participant*	string	ISPB do Participante Debitado (Requisitante, o qual está pedindo a devolução).	8
refund_request_details*	string	Detalhes da devolução.	-
analysis_result*	enum	Resultado da análise de fechamento da devolução.	Enumeradores analysis_result
analysis_details*	string	Detalhes da análise de fechamento da devolução.	-
reject_reason*	string	Motivo da rejeição da devolução, caso seja fechada com REJECTED.	Enumeradores reject_reason
refund_transfer_key*	string	pix_transfer_key da transação de devolução, caso seja fechada com aceite.	-
refunded_amount*	float	Valor devolvido na transação de devolução.	-
refund_request_direction*	string	Direção da solicitação de devolução.	Enumeradores refund_request_direction
created_at *	string	Data de criação da Solicitação de Devolução	24

Enumeradores refund_request_status

Campo	Descrição
open	Solicitação de Devolução foi criada e está aberta no BACEN.
cancelled	Solicitação de Devolução está cancelada no BACEN
closed	Solicitação de Devolução está fechada no BACEN

Enumeradores refund_request_type

Campo	Descrição
fraud	Solicitação de Devolução originada de uma fraude.
operational_flaw	Solicitação de Devolução originada de um erro interno.

Enumeradores analysis_result

Campo	Descrição
totally_accepted	Solicitação de Devolução foi totalmente aceita.
partially_accepted	Solicitação de Devolução foi parcialmente aceita;
rejected	Solicitação de Devolução foi rejeitada.

Enumeradores reject_reason

Campo	Descrição
no_balance	Conta não possui saldo para realizar a devolução.
account_closure	Conta se encontra fechada e, portanto, não é possível realizar a devolução
other	Outro motivo

Enumeradores refund_request_direction

Campo	Descrição
outgoing	Participante é originador do pedido de devolução.
incoming	Participante é o alvo do pedido de devolução