跳到主要内容

PIX Infraction Report

Infraction Reports 对象定义​

Request Body
{
    "infraction_report_type": "compliance",
    "infraction_report_details": "Cliente realizou várias compras de valor alto em estabelecimentos comerciais cuja atividade econômica é de alto risco de lavagem de dinheiro. Após uma investigação minuciosa, decidiu-se realizar o report ao COAF e bloquear o saldo em conta até que a origem do dinheiro seja esclarecida. ",
    "infraction_report_creator": "external",
    "infraction_report_date": "2020-10-14T00:25:42-03:00",
    "infraction_report_status": "received",
    "infraction_report_events": [               
        {
            "new_status": "received",
            "event_date": "2020-10-14T00:25:42-03:00"
        }
    ]
}

如果交易任何一方发现可疑行为，可以创建 Infraction Report 来举报该嫌疑。该 Infraction Report 随后将由对方分析并决定是否确认。根据 BCB 的标准，Infraction Report 应具有以下字段：

名称类型描述
infraction_report_type枚举定义交易中存在的可疑活动类型的枚举值。
infraction_report_detailsstring导致 Infraction Report 创建者认为交易可能存在某种违规的情况详情。
infraction_report_creator枚举定义 Infraction Report 创建者的枚举值。
infraction_report_datedatetime事件日期。

infraction_report_type 字段可包含枚举值：fraud 和 compliance。

infraction_report_creator 字段可包含枚举值：client 和 external。

发送 Infraction Report​

Request Body
{
    "infraction_report_type": "compliance",
    "infraction_report_details": "Cliente realizou várias compras de valor alto em estabelecimentos comerciais cuja atividade econômica é de alto risco de lavagem de dinheiro. Após uma investigação minuciosa, decidiu-se realizar o report ao COAF e bloquear o saldo em conta até que a origem do dinheiro seja esclarecida. ",
    "infraction_report_creator": "external",
    "infraction_report_date": "2020-10-14T00:25:42-03:00"
}
Response Body
  {
    "infraction_report_key": "7f85e162-5a7d-41fa-a578-69df6f3df958",
    "infraction_report_status": "received"
  }

要发送 Infraction Report，只需向以下端点发送请求：

POST https://api.caas.qitech.app/pix/transaction/{transaction_id}/infraction_report

其中 transaction_id 是在注册时发送给我们的交易标识符，位于 "id" 字段中。

查询 Infraction Report​

Response Body
  {
      "infraction_report_type": "compliance",
      "infraction_report_details": "Cliente realizou várias compras de valor alto em estabelecimentos comerciais cuja atividade econômica é de alto risco de lavagem de dinheiro. Após uma investigação minuciosa, decidiu-se realizar o report ao COAF e bloquear o saldo em conta até que a origem do dinheiro seja esclarecida. ",
      "infraction_report_creator": "external",
      "infraction_report_date": "2020-10-14T00:25:42-03:00",
      "infraction_report_status": "received",
      "infraction_report_events": [               
          {
              "new_status": "received",
              "event_date": "2020-10-14T00:25:42-03:00"
          }
      ],
      "transaction_data": {
        "transaction_direction": "received",
        "id": "082373263",
        ...
      }
  }

要查询 Infraction Report，只需向以下端点发送请求：

GET https://api.caas.qitech.app/pix/transaction/{transaction_id}/infraction_report/{infraction_report_key}

随后将返回与提供的 transaction_id 关联且 infraction_report_key 与发送的密钥相同的 Infraction Report 对象。

更新 Infraction Report​

Request Body
  {
    "infraction_report_status": "acknowledged",
    "event_date": "2020-10-07T15:06:25-03:00"
  }

Infraction Report 在 BCB 完成前有多个阶段。因此，需要通过以下端点通知 Infraction Report 的所有状态更新：

PUT https://api.caas.qitech.app/pix/transaction/{transaction_id}/infraction_report/{infraction_report_key}