checkresult (New)

Overview 

API URL: /api/v3/aml/nss/checkTasks

API Description: Provides real-time scanning of related tasks.

Structure 

Request Parameters 

Parameter

Data Type

Max Length

Description

Example

eventId

String

32B

Required. The call ID generated by the AML system. Obtain it from screen (new).

"6728d09e2113b33b6cc7e47a361c****"

Response Parameters 

Parameter

Data Type

Is return required?

Description

Example

result

Result

Yes

The API request result, which contains information about the result of the API request, such as status and error codes. 

{

"resultStatus": "S",

"resultCode": "SUCCESS",

"resultMessage": "Success"

}

caseDetails

List<ZolozAlertTaskBO>

No

For more details on case results, see ZolozAlertTaskBO

[

{

"decision": "REJECT",

"status": "CLOSED",

"taskId": "A2022112130307****",

"type": "SANCTION",

"customerId": "2088000****",

"crrRiskLevel": "",

"createTime": "1693221462732",

"updateTime": "1693221462732",

"modifier": "12345678@163.com"

}

]

ZolozAlertTaskBO

Parameter

Data Type 

Is return required?

Description

Example

taskId

String

No

Unique case Id for a case.

"A2022112130307183A"

type

String

No

Case types. Possible values are as below:

  • PEP: Politically Exposed Person
  • SANCTION: sanctioned individuals and entities 
  • NEGATIVE_NEWS: individuals and entities associated with bad press 
  • INTERNAL_LIST: custom list 
  • EDD: Enhanced Due Diligence

"SANCTION"

status

String

No

Case status. The following values are supported:

  • NEW: newly created alert case, not reviewed yet.
  • REVIEW: alert case is currently being reviewed.
  • CLOSED: alert case review has finished.

"CLOSED"

decision

String

No

Case review results. 

  • When the case type is PEP/SANCTION/NEGATIVE_NEWS/INTERNAL_LIST,the following case review results are returned:
    • ACCEPT: Non-hit
    • REJECT: Hit
  • When the case type is EDD, the following case review results are returned:
    • Maintain: Maintains the existing risk rating without manual adjustment.
    • Adjust: Manually adjust the risk rating. 
    • Terminate: Terminate relationship with the customer. 

"ACCEPT"

crrRiskLevel

String

No

Customer risk rating, this field is returned for EDD case types. 

  • HIGH: high risk 
  • MEDIUM: medium risk
  • LOW: low risk 

"HIGH"

customerId

String

No

Customer ID in merchant system.

"2088000****"

createTime

Timestamp

No

Case creation time in Unix timestamp format (milliseconds)

"1693221462732"

updateTime

Timestamp

No

Case update time in Unix timestamp format (milliseconds)

"1693221462732"

modifier

String

No

Case modifier.

"12345678@163.com"

Samples

Request Sample

The following sample shows what a request sent from the merchant server looks like.

copy
{
    "eventId": "6728d09e2113b33b6cc7e47a361c****"
}

Response Sample 

The following sample shows what a response returned from the ZOLOZ server looks like. 

copy
{
    "caseDetails": [
        {
            "decision": "REJECT", 
            "status": "CLOSED", 
            "taskId": "A2022112130307****", 
            "type": "SANCTION", 
            "customerId": "2088000****", 
            "crrRiskLevel": "", 
            "createTime": "1693221462732", 
            "updateTime": "1693221462732", 
            "modifier": "12345678@163.com"
        }
    ], 
    "result": {
        "resultCode": "SUCCESS", 
        "resultMessage": "Success", 
        "resultStatus": "S"
    }
}