发起违规举报

违规举报是巴西中央银行定义的特殊退款机制（MED）的服务之一。

当发现可疑的欺诈性交易、退款请求或退款取消时，可以创建违规举报，以通知 BACEN 和另一个参与者该操作存在违规行为。

借记方和贷记方参与者均可创建违规举报。

注意

要理解违规举报流程，需要了解创建举报的间接参与者可以使用哪些接口端点。

当间接参与者开启违规举报时，如果举报生成有误，可以（如有必要）取消该举报。

当间接参与者收到违规举报时，必须提供分析结果并关闭该举报。

以上两种流程将在以下章节中详细说明。

重要

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

如果间接参与者有延迟，QI Tech 将以agreed状态关闭违规举报，以避免机构被巴西中央银行处罚。

重要

只有转账的发起方参与者才能对该转账创建违规举报。

请求

ENDPOINT

/pix/infraction_report

MÉTODO

POST

请求体

{
    "pix_transfer_key": "c09fef15-ab30-469c-a1d4-4e9dd479943a",
    "request_control_key": "c09fef15-ab30-469c-a1d4-4e9dd479943a",
    "infraction_report_type": "refund_request",
    "infraction_report_details": "Foi identificado uma fraude na transação",
    "infraction_report_situation": "scam"
}

请求体参数

字段	类型	描述	字符数
`request_control_key` *	uuidv4	用于查询所发请求的 UUID4。	36
`pix_transfer_key` *	uuidv4	PIX 交易的唯一标识符。	36
`infraction_report_type` *	enum	要创建的违规举报类型。	infraction_report_type 枚举值
`infraction_report_details`	string	关于要创建的违规举报的详细信息。	10
`infraction_report_situation`	string	违规发生的情形。	infraction_report_situation 枚举值

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	不适用于上述列举的其他任何原因。	-

响应

STATUS

200

响应体

{
    "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": "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
`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_direction 枚举值

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

请求​

请求体参数​

infraction_report_type 枚举值​

infraction_report_situation 枚举值​

响应​

响应体参数​

infraction_report_status 枚举值​

infraction_report_direction 枚举值​

请求