接收违规举报

由于其他参与者可能以间接参与者为目标开启违规举报，QI Tech 有必要将其他参与者开启的举报通知间接参与者。

QI Tech 将对受管理的间接参与者的新举报进行定期轮询，并通过 webhook 以 acknowledged 状态通知对应参与者。

重要

巴西中央银行规定，间接参与者收到违规举报后的7天内，必须关闭该举报。

如果间接参与者有延迟，QI Tech 将在发送接收违规 webhook 后的6个自然日后，以 agreed 状态关闭违规举报，以避免机构被巴西中央银行处罚。

违规举报的状态始终为 acknowledged，表示 QI Tech 已收到该举报并将发送给间接参与者。

信息

本介绍部分所描述的所有内容，也在与违规通知相关的章节中进行了详细说明，包括间接参与者应如何通过 API 处理。

违规举报接收 Webhook

请求体

{
    "infraction_report_key":"d7820e2f-1c23-4610-83d6-d9aad1845075",
    "pix_transfer_key":"cdcf0d25-08a1-46e3-902a-6d7ca75e6c48",
    "end_to_end_id":"E99999010202406251332F8n7dMUwOLE",
    "infraction_report_status":"acknowledged",
    "infraction_report_situation":"scam",
    "infraction_report_type":"refund_request",
    "report_details":"usuario caiu em golpe…",
    "debited_participant":"99999011",
    "credited_participant":"99999010",
    "infraction_report_direction": "incoming",
    "created_at": "2023-03-03T12:04:06.179Z",
    "updated_at": "2023-03-03T12:04:06.179Z"
}

响应体参数

字段	类型	描述	字符数
infraction_report_key *	string	违规举报的唯一标识符。	36
pix_transfer_key *	string	PIX 交易的唯一标识符。	36
end_to_end_id *	string	BACEN 中 PIX 交易的唯一标识符。	36
infraction_report_status *	enum	状态。	infraction_report_status 枚举值
infraction_report_situation *	enum	违规发生的情形。	infraction_report_situation 枚举值
infraction_report_type *	enum	违规举报类型。	infraction_report_type 枚举值
infraction_report_details	string	关于已创建违规举报的详细信息。	<= 2000
credited_participant *	string	贷记方参与者的 ISPB。	8
debited_participant *	string	借记方参与者的 ISPB。	8
infraction_report_direction *	enum	表示举报是由间接参与者开启还是由其他参与者开启的枚举值。	infraction_report_direction 枚举值
created_at *	string	违规举报的创建时间。	24
updated_at	string	违规举报的更新时间。	24

infraction_report_status 枚举值

字段	类型	描述	字符数
open	string	违规举报已创建并在 BACEN 中处于开启状态。	-
acknowledged	string	违规举报已被被申诉参与者接收。	-
cancelled	string	违规举报在 BACEN 中已取消。	-
closed	string	违规举报在 BACEN 中已关闭。	-

infraction_report_type 枚举值

字段	类型	描述	字符数
refund_cancelled	string	因退款取消而生成的违规举报。	16
refund_request	string	为申请退款而生成的违规举报。	14

infraction_report_situation 枚举值

字段	类型	描述	字符数
scam	string	诈骗或欺诈行为。	-
account_takeover	string	来源账户未授权的交易。	-
coercion	string	胁迫犯罪。	-
fraudulent_access	string	对来源账户的欺诈性访问。	-
other	string	不适用于上述列举的其他任何原因。	-

infraction_report_direction 枚举值

字段	类型	描述	字符数
incoming	string	以间接参与者为目标的违规举报。	-
outgoing	string	以间接参与者为发起方的违规举报。	-

违规举报变更接收 Webhook

请求体

{
    "infraction_report_key":"d7820e2f-1c23-4610-83d6-d9aad1845075",
    "pix_transfer_key":"cdcf0d25-08a1-46e3-902a-6d7ca75e6c48",
    "end_to_end_id":"E99999010202406251332F8n7dMUwOLE",
    "infraction_report_status":"closed",
    "infraction_report_situation":"scam",
    "infraction_report_type":"refund_request",
    "report_details":"usuario caiu em golpe…",
    "debited_participant":"99999011",
    "credited_participant":"99999010",
    "analysis_result": "agreed",
    "analysis_details": "Valor bloqueado. Para mais informações ligue para (11) 98871-1385.",
    "infraction_report_direction": "outgoing",
    "created_at": "2023-03-03T12:04:06.179Z",
    "updated_at": "2023-03-03T12:04:06.179Z"
}

响应体参数

字段	类型	描述	字符数
infraction_report_key *	string	违规举报的唯一标识符。	36
pix_transfer_key *	string	PIX 交易的唯一标识符。	36
end_to_end_id *	string	BACEN 中 PIX 交易的唯一标识符。	36
infraction_report_status *	enum	状态。	infraction_report_status 枚举值
infraction_report_situation *	enum	违规发生的情形。	infraction_report_situation 枚举值
infraction_report_type *	enum	违规举报类型。	infraction_report_type 枚举值
infraction_report_details	string	关于已创建违规举报的详细信息。	<= 2000
credited_participant *	string	贷记方参与者的 ISPB。	8
debited_participant *	string	借记方参与者的 ISPB。	8
analysis_result *	string	分析结果。	analysis_result 枚举值
analysis_details *	string	关于分析结果的描述。	250
infraction_report_direction *	enum	表示举报是由间接参与者开启还是由其他参与者开启的枚举值。	infraction_report_direction 枚举值
created_at *	string	违规举报的创建时间。	24
updated_at	string	违规举报的更新时间。	24

analysis_result 枚举值

字段	类型	描述	字符数
agreed	string	间接参与者同意其他参与者创建的违规举报。	-
disagreed	string	间接参与者不同意其他参与者创建的违规举报。	-