关闭违规举报

QI Tech 负责对巴西中央银行进行轮询，以验证是否有其他参与者为间接参与者创建的违规举报，并将通过 webhook（已附带 acknowledged 状态）通知间接参与者。

为通知间接参与者有需要其响应的违规举报，QI Tech 将发送一个接收 webhook。

重要

需要注意的是，只有收到违规举报的参与者才能关闭它。

重要

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

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

关闭违规举报时，状态必须为 acknowledged。

请求

ENDPOINT

/pix/infraction_report/INFRACTION_REPORT_KEY

MÉTODO

PATCH

请求体 - 接受

{
    "infraction_report_status": "closed",
    "request_control_key": "feb59932-be7a-4584-9830-02ed8bc0aa77",
    "analysis_result": "agreed",
    "fraud_type": "application_fraud",
    "analysis_details": "Valor bloqueado. Para mais informações ligue para (11) 98871-1385.",
}

请求体 - 拒绝

{
    "infraction_report_status": "closed",
    "request_control_key": "feb59932-be7a-4584-9830-02ed8bc0aa77",
    "analysis_result": "disagreed",
    "analysis_details": "Valor bloqueado. Para mais informações ligue para (11) 98871-1385.",
}

路径参数

字段	类型	描述	字符数
`infraction_report_key`	string	要关闭的已创建违规举报的 UUID4。	36

请求体参数

字段	类型	描述	字符数
`analysis_result` *	enum	分析结果。	analysis_result 枚举值
`request_control_key` *	uuidv4	用于查询所发请求的 UUID4。	36
`infraction_report_status` *	enum	要设置的违规举报状态。	infraction_report_status 枚举值
`fraud_type`	enum	查明的欺诈类型。不属于违规举报实体，但关闭时需要填写。	fraud_type 枚举值
`analysis_details`	string	关于分析结果的描述。	250

analysis_result 枚举值

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

infraction_report_status 枚举值

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

fraud_type 枚举值

字段	类型	描述	字符数
`application_fraud`	string	以他人文件伪造身份的欺诈。	-
`mule_account`	string	通过合法开设的空壳账户进行欺诈。	-
`scammer_account`	string	目标账户以真实欺诈者名义开设的欺诈。	-
`other`	string	不属于上述枚举的其他性质欺诈。	-

响应

STATUS

200

响应体

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

响应体参数

字段	类型	描述	字符数
`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

infraction_report_situation 枚举值

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

infraction_report_type 枚举值

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

infraction_report_direction 枚举值

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

请求​

路径参数​

请求体参数​

analysis_result 枚举值​

infraction_report_status 枚举值​

fraud_type 枚举值​

响应​

响应体参数​

infraction_report_situation 枚举值​

infraction_report_type 枚举值​

infraction_report_direction 枚举值​

请求