Recebimento de Relatos de Infração

Ao receber um relato de infração, a QI Tech automaticamente bloqueará o recurso da conta equivalente à transação contestada, e enviará notificações de acompanhamento sobre todo o ciclo da infração, inclusive dando chance do cliente justificar a transação, entretanto, vale ressaltar que a decisão final sobre acatar ou não uma infração partirá da QI Tech. Toda a comunicação relativa às infrações são realizadas via webhooks.

Webhook de uma incoming infraction report

Uma incoming infraction report é uma infração aberta por outro banco, onde o dono da conta é o alvo da transação contestada.

Webhook request body

Webhook: incoming infraction report

{
  "event_datetime": "2024-07-22T10:31:09Z",
  "key": "15d91f4b-a55c-41a6-9c46-2704253a1cf7",
  "data": {
    "target_person_key": "4f6ea994-e53a-4ef8-b2b0-89d14c4667bc",
    "end_to_end_id": "E12345678202407171627342xlR8KpoD",
    "pix_transfer_key": "6cf241f8-328a-4813-90ab-2aef74d853ac",
    "target_account_key": "9d5b1a98-03ac-4202-91e8-29dbff3d1108",
    "infraction_report_status": "pending_client_awnser",
    "infraction_report_situation": "fraudulent_access",
    "analysis_result": null,
    "analysis_details": null,
    "infraction_report_type": "refund_request",
    "debited_participant": "12345678",
    "credited_participant": "32402502",
    "blocked_balance_status": "completelly_blocked",
    "infraction_report_key": "90b4e1bc-89bc-4df8-98a2-f912447b178f",
    "infraction_report_details": "Transação acusada como fraudulenta pelo originador.",
    "client_details": null,
    "created_at": "2024-07-22T13:31:09Z",
    "updated_at": "2024-07-22T13:31:09Z",
  },
  "status": "pending_client_awnser",
  "webhook_type": "incoming.internal_infraction_report"
}

Campo	Tipo	Descrição	Caracteres
event_datetime *	string	Data e hora de criação da transação.	20
key *	enum	Chave única de identificação do envio do evento.	32
data *	string	Objeto incoming infraction report data.	Objeto incoming_infraction_report
status *	string	Status da infração.	Enumeradores incoming_infraction_report_status

Objeto incoming_infraction_report

Campo	Tipo	Descrição	Caracteres
target_person_key *	string	Person key do alvo da infração.	32
end_to_end_id *	string	end_to_end_id da transação original.	32
pix_transfer_key *	string	Pix transfer key da transação original.	32
target_account_key *	string	Account key da conta de destino da transação original.	32
infraction_report_status *	string	Status da infração.	Enumeradores incoming_infraction_report_status
infraction_report_situation *	string	Situação da infração.	Enumeradores infraction_report_situation
analysis_result	string	Resultado da análise. Decidido pela QI Tech.	Enumeradores infraction_report_analysis_result
analysis_details	string	Justificativa do resultado da análise.	200
infraction_report_type *	string	Tipo do relato de infração.	Enumeradores infraction_report_type
debited_participant *	string	Participante que originou a transação.	8
credited_participant *	string	Participante que recebeu a transação.	8
blocked_balance_status *	string	Status do bloqueio de saldo da conta de destino.	Enumeradores blocked_balance_status
infraction_report_key *	string	UUID4 identificador da transação no Bacen.	32
infraction_report_details	string	Detalhes da infração, enviados pelo outro participante.	2000
client_details	string	Detalhes fornecidos pelo cliente sobre a transação original.	2000
created_at *	string	Data e hora de alteração da transação.	20
updated_at *	string	Data e hora de criação da transação.	20

Enumeradores incoming_infraction_report_status

Enumerador	Descrição
pending_client_awnser	Infração recebida, aguardando justificativa do cliente.
pending_approval	Justificativa enviada, aguardando aprovação interna.
automatically_closed	Fechado automaticamente devido a falta de resposta do cliente.
manually_closed	Fechado pela QI Tech após análise da resposta do cliente.
cancelled	Cancelada pelo originador.

Enumeradores infraction_report_situation

Enumerador	Descrição
scam	Causa de golpe ou estelionato.
account_takeover	Causa de transação não autorizada pela conta de origem.
coercion	Causa de crime de coerção.
fraudulent_access	Causa de acesso fraudulento à conta de origem.
other	Quaisquer causas não aplicáveis às listadas acima.

Enumeradores infraction_report_analysis_result

Enumerador	Descrição
agreed	O Participante Indireto concorda com o Relato de Infração criado pelo outro Participante.
disagreed	O Participante Indireto discorda com o Relato de Infração criado pelo outro Participante.

Enumeradores infraction_report_type

Enumerador	Descrição
refund_cancelled	Relato de infração será gerado pelo motivo de uma devolução cancelada.
refund_request	Relato de infração será gerado a fim de se solicitar uma devolução.

Enumeradores blocked_balance_status

Enumerador	Descrição
no_balance	Conta do cliente sem saldo. Monitorando saldo pendente.
completelly_blocked	Recursos equivalentes à transação completamente bloqueados.
partially_blocked	Recursos equivalentes à transação parcialmente bloqueados. Monitorando saldo.
settled	Infração aceita, e pagamento do pedido de devolução realizado.
partially_settled	Infração aceita, e pagamento do pedido de devolução parcialmente realizado.
released	Recursos liberados, seja por cancelamento da infração ou fechamento em desacordo.

info

Uma infração será fechada automaticamente aceitando caso o cliente não responda à infração em 5 dias.

Webhook de uma outgoing infraction report

Uma outgoing infraction report é uma infração aberta pela QI, tendo como alvo outro participante.

Webhook request body

Webhook: outgoing infraction report

{
  "event_datetime": "2024-07-22T10:31:09Z",
  "key": "15d91f4b-a55c-41a6-9c46-2704253a1cf7",
  "data": {
    "infraction_report_key": "4f6ea994-e53a-4ef8-b2b0-89d14c4667bc",
    "pix_transfer_key": "6cf241f8-328a-4813-90ab-2aef74d853ac",
    "source_account_key": "9d5b1a98-03ac-4202-91e8-29dbff3d1108",
    "end_to_end_id": "E32402502202407171627342xlR8KpoD",
    "infraction_report_status": "open",
    "infraction_report_situation": "account_takeover",
    "infraction_report_type": "refund_request",
    "infraction_report_details": "Transação fraudulenta.",
    "debited_participant": "32402502",
    "credited_participant": "12345678",
    "analysis_result": null,
    "analysis_details": null,
    "updated_at": "2024-07-22T13:31:09Z",
    "created_at": "2024-07-22T13:31:09Z",
},
  "status": "open",
  "webhook_type": "outgoing.internal_infraction_report"
}

Campo	Tipo	Descrição	Caracteres
event_datetime *	string	Data e hora de criação da transação.	20
key *	enum	Chave única de identificação do envio do evento.	32
data *	string	Objeto outgoing infraction report data.	Objeto outgoing_infraction_report
status *	string	Status da infração.	Enumeradores infraction_report_status

Objeto outgoing_infraction_report

Campo	Tipo	Descrição	Caracteres
infraction_report_key *	string	UUID4 identificador da transação no Bacen.	32
end_to_end_id *	string	end_to_end_id da transação original.	32
pix_transfer_key *	string	Pix transfer key da transação original.	32
source_account_key *	string	Account key da conta de origem da transação original.	32
infraction_report_status *	string	Status da infração.	Enumeradores outgoing_infraction_report_status
infraction_report_situation *	string	Situação da infração.	Enumeradores infraction_report_situation
infraction_report_type *	string	Tipo do relato de infração.	Enumeradores infraction_report_type
infraction_report_details	string	Detalhes da infração, enviados pela QI Tech.	2000
debited_participant *	string	Participante que originou a transação.	8
credited_participant *	string	Participante que recebeu a transação.	8
analysis_result	string	Resultado da análise. Decidido pelo outro participante.	Enumeradores infraction_report_analysis_result
analysis_details	string	Justificativa do resultado da análise.	200
created_at *	string	Data e hora de alteração da transação.	20
updated_at *	string	Data e hora de criação da transação.	20

Enumeradores outgoing_infraction_report_status

Enumerador	Descrição
open	Infração aberta e enviada ao outro participante.
closed	Infração respondida pelo outro participante.
cancelled	Infração cancelada pela QI Tech.