跳到主要内容

取消违规举报

如果违规举报请求系错误生成，间接参与者希望取消，可通过以下端点操作。

重要

需要注意的是，只有创建了违规举报的参与者才能取消它，即使违规状态为 closed，也可以进行取消操作。

重要

已取消的违规举报可以使用列出违规举报端点进行查询。

请求​

ENDPOINT
/pix/infraction_report/INFRACTION_REPORT_KEY
MÉTODO
PATCH
请求体
{
    "infraction_report_status": "cancelled",
    "request_control_key": "750cbfa0-f628-4944-a76c-9053bf1ebc87",
}

路径参数​

字段类型描述字符数
infraction_report_keystring要取消的已创建违规举报的 UUID4。36

请求体参数​

字段类型描述字符数
infraction_report_status *string要更新违规举报的目标状态。36
request_control_key *string客户使用的请求唯一标识密钥，格式为 uuid v4。36

响应​

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",
   "infraction_report_direction": "outgoing",
   "created_at": "2023-03-03T12:04:06.179Z",
   "updated_at": "2023-03-03T12:05:03.421Z"
}

响应体参数​

字段类型描述字符数
infraction_report_key *string违规举报的唯一标识符。36
pix_transfer_key *stringPIX 交易的唯一标识符。36
end_to_end_id *stringBACEN 中 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_detailsstring关于已创建违规举报的详细信息。<= 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 枚举值​

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

infraction_report_situation 枚举值​

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

infraction_report_type 枚举值​

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

infraction_report_direction 枚举值​

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