跳到主要内容

场景模拟

逐步模拟外部代理执行操作的过程。这些模拟包括违规举报的接收和更新。

信息

这些请求没有返回载荷（响应体），只有状态码 204 的响应状态。由模拟生成的内容需通过 webhook 接收。

1 - 模拟接收违规举报​

模拟接收由其他机构开启的违规举报。

重要

发送请求时必须有一个有效的 pix_transfer_key，不必特别关注转账另一方的信息，因为在模拟过程中第二个参与者的所有信息都将被替换。

请求​

ENDPOINT
/mock/pix/infraction_report
MÉTODO
POST
请求体
{
  "infraction_report_status": "acknowledged",
  "pix_transfer_key": "28290ff2-2ba7-4e85-9a5e-862c92259b33",
  "infraction_report_type": "refund_request",
  "infraction_report_situation": "scam",
  "infraction_report_details": "Transação com suspeita de fraude.",
}

请求体对象​

字段类型描述最大字符数
infraction_report_status*string违规举报的接收状态："acknowledged"。infraction_report_status 枚举值
pix_transfer_key*stringUUID4，标识相关交易的唯一密钥。36
infraction_report_type*string违规举报类型。infraction_report_type 枚举值
infraction_report_situation*string违规发生的情形。infraction_report_situation 枚举值
infraction_report_details*string违规举报详细信息。2000

infraction_report_status 枚举值​

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

infraction_report_type 枚举值​

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

infraction_report_situation 枚举值​

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

2 - 模拟更新违规举报​

模拟由间接参与者开启的违规举报的状态更新。

违规举报更新的模拟选项包括：

1 - 取消：模拟由另一参与者对其之前自行开启的违规举报执行取消（cancel）操作。

2 - 关闭：模拟由另一参与者对间接参与者开启的违规举报执行关闭（close）操作。

请求​

ENDPOINT
/mock/pix/infraction_report
MÉTODO
PATCH
请求体 - 取消
重要

由 infraction_report_key 标识的违规举报必须已在接收违规举报模拟中预先创建。

{
  "infraction_report_status": "cancelled",
  "infraction_report_key": "28290ff2-2ba7-4e85-9a5e-862c92259b34"
}
请求体 - 关闭
重要

由 infraction_report_key 标识的违规举报必须已由间接参与者预先创建，并在违规举报更新模拟中完成确认。

{
  "infraction_report_status": "closed",
  "infraction_report_key": "28290ff2-2ba7-4e85-9a5e-862c92259b34",
  "analysis_result": "agreed",
  "analysis_details": "Valor bloqueado. Para mais informações ligue para (99) 99999-9999."
}

请求体对象​

字段类型描述最大字符数备注
infraction_report_status*string违规举报的新状态："cancelled"、"closed"。infraction_report_status 枚举值----
infraction_report_key*string违规举报的唯一密钥。36----
analysis_result*string违规举报的分析结果："agreed" 或 "disagreed"。analysis_result 枚举值状态为 "closed" 时必填
analysis_details*string违规举报分析详细信息。2000状态为 "closed" 时必填

analysis_result 枚举值​

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