Skip to main content

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"
}
CampoTipoDescriçãoCaracteres
event_datetime *stringData e hora de criação da transação.20
key *enumChave única de identificação do envio do evento.32
data *stringObjeto incoming infraction report data.Objeto incoming_infraction_report
status *stringStatus da infração.Enumeradores incoming_infraction_report_status

Objeto incoming_infraction_report

CampoTipoDescriçãoCaracteres
target_person_key *stringPerson key do alvo da infração.32
end_to_end_id *stringend_to_end_id da transação original.32
pix_transfer_key *stringPix transfer key da transação original.32
target_account_key *stringAccount key da conta de destino da transação original.32
infraction_report_status *stringStatus da infração.Enumeradores incoming_infraction_report_status
infraction_report_situation *stringSituação da infração.Enumeradores infraction_report_situation
analysis_resultstringResultado da análise. Decidido pela QI Tech.Enumeradores infraction_report_analysis_result
analysis_detailsstringJustificativa do resultado da análise.200
infraction_report_type *stringTipo do relato de infração.Enumeradores infraction_report_type
debited_participant *stringParticipante que originou a transação.8
credited_participant *stringParticipante que recebeu a transação.8
blocked_balance_status *stringStatus do bloqueio de saldo da conta de destino.Enumeradores blocked_balance_status
infraction_report_key *stringUUID4 identificador da transação no Bacen.32
infraction_report_detailsstringDetalhes da infração, enviados pelo outro participante.2000
client_detailsstringDetalhes fornecidos pelo cliente sobre a transação original.2000
created_at *stringData e hora de alteração da transação.20
updated_at *stringData e hora de criação da transação.20

Enumeradores incoming_infraction_report_status

EnumeradorDescrição
pending_client_awnserInfração recebida, aguardando justificativa do cliente.
pending_approvalJustificativa enviada, aguardando aprovação interna.
automatically_closedFechado automaticamente devido a falta de resposta do cliente.
manually_closedFechado pela QI Tech após análise da resposta do cliente.
cancelledCancelada pelo originador.

Enumeradores infraction_report_situation

EnumeradorDescrição
scamCausa de golpe ou estelionato.
account_takeoverCausa de transação não autorizada pela conta de origem.
coercionCausa de crime de coerção.
fraudulent_accessCausa de acesso fraudulento à conta de origem.
otherQuaisquer causas não aplicáveis às listadas acima.

Enumeradores infraction_report_analysis_result

EnumeradorDescrição
agreedO Participante Indireto concorda com o Relato de Infração criado pelo outro Participante.
disagreedO Participante Indireto discorda com o Relato de Infração criado pelo outro Participante.

Enumeradores infraction_report_type

EnumeradorDescrição
refund_cancelledRelato de infração será gerado pelo motivo de uma devolução cancelada.
refund_requestRelato de infração será gerado a fim de se solicitar uma devolução.

Enumeradores blocked_balance_status

EnumeradorDescrição
no_balanceConta do cliente sem saldo. Monitorando saldo pendente.
completelly_blockedRecursos equivalentes à transação completamente bloqueados.
partially_blockedRecursos equivalentes à transação parcialmente bloqueados. Monitorando saldo.
settledInfração aceita, e pagamento do pedido de devolução realizado.
partially_settledInfração aceita, e pagamento do pedido de devolução parcialmente realizado.
releasedRecursos 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"
}
CampoTipoDescriçãoCaracteres
event_datetime *stringData e hora de criação da transação.20
key *enumChave única de identificação do envio do evento.32
data *stringObjeto outgoing infraction report data.Objeto outgoing_infraction_report
status *stringStatus da infração.Enumeradores infraction_report_status

Objeto outgoing_infraction_report

CampoTipoDescriçãoCaracteres
infraction_report_key *stringUUID4 identificador da transação no Bacen.32
end_to_end_id *stringend_to_end_id da transação original.32
pix_transfer_key *stringPix transfer key da transação original.32
source_account_key *stringAccount key da conta de origem da transação original.32
infraction_report_status *stringStatus da infração.Enumeradores outgoing_infraction_report_status
infraction_report_situation *stringSituação da infração.Enumeradores infraction_report_situation
infraction_report_type *stringTipo do relato de infração.Enumeradores infraction_report_type
infraction_report_detailsstringDetalhes da infração, enviados pela QI Tech.2000
debited_participant *stringParticipante que originou a transação.8
credited_participant *stringParticipante que recebeu a transação.8
analysis_resultstringResultado da análise. Decidido pelo outro participante.Enumeradores infraction_report_analysis_result
analysis_detailsstringJustificativa do resultado da análise.200
created_at *stringData e hora de alteração da transação.20
updated_at *stringData e hora de criação da transação.20

Enumeradores outgoing_infraction_report_status

EnumeradorDescrição
openInfração aberta e enviada ao outro participante.
closedInfração respondida pelo outro participante.
cancelledInfração cancelada pela QI Tech.