Person Re-Evaluation

/personreevaluate

Method : GET
URL : https://xxx.finexusgroup.com/acdd/rest/v1/personreevaluate

info

This method allows the submission of a request to re-evaluate the recommendation made in an earlier /checkpersoncdd POST request.

Request

Request Parameters

Field Name	Required	Type	Length	Description	Example
source	Yes	String	16	Source.	"FNXCRDS"
partnerId	Yes	String	128	Partner ID.	"BSSS"
productType	Yes	String	128	Product type.	"loanapplication"
reference	Yes	String	64	Unique reference number.	"2`003160192931"
referenceId	Yes	String	64	Reference ID.	"2003160192931"
apiVersion	Yes	String	8	API version.	"1.2"
language	Optional	String	2	Language.	"en","ms"
apiKey	Optional	String	64	API key.	"123KEJRU001"

Response

Response Codes

Response Code	Description	Response Schema
200	Allow.	CDDPostResponse
400	Bad request.	N/A
401	Unauthorised access.	N/A
405	Forbidden access.	N/A

Response Parameters

Field Name	Required	Type	Length	Description	Example
status	Yes	Object		Status.	Refer to explanation below.
payload	Optional	Object		Re-evaluation result.	Refer to explanation below.

Object: status

Field Name	Required	Type	Length	Description	Example
sourceInfo	Yes	Object		Source information.	Refer to explanation below.
errorlist	Yes	Object		Error list.	Refer to explanation below.
status	Yes	String	16	Status.	"SUCCESS","QUEUED","FAIL"

Object: sourceInfo

Field Name	Required	Type	Length	Description	Example
source	Yes	String	16	Source.	"FNXCRDS"
partnerId	Yes	String	128	Partner ID.	"BSSS"
productType	Yes	String	128	Product Type.	"BSSS01"
reference	Yes	String	64	Reference.	"50074154501001"
referenceId	Yes	String	64	Reference ID.	"50074154501001"
apiVersion	Yes	String	8	API Version.	"1.2"
apiKey	Conditional	String	64	API Key.	"123KEJRU001"

Object: errorList

Field Name	Required	Type	Length	Description	Example
msgText	Yes	String	128	Message text.	"Re-evaluation unsuccessfully retrieved."
msgCode	Yes	String	8	Message code.	"404"

Object: payload

Field Name	Required	Type	Length	Description	Example
highriskCountry	Yes	String	2	High-risk country.	"T","F"
blacklistReport	Yes	String	2	Blacklist report.	"T","F"
scReport	Yes	String	2	Securities Commissions report.	"T","F"
maccReport	Yes	String	2	Malaysian Anti-Corruption Commissions report.	"T","F"
bnmReport	Yes	String	2	Bank Negara Malaysia report.	"T","F"
kdnReport	Yes	String	2	Kementerian Dalam Negeri report.	"T","F"
unscReport	Yes	String	2	United Nations Security Council report.	"T","F"
ofacReport	Yes	String	2	Office of Foreign Assets Control report.	"T","F"
ctosReport	Yes	String	2	CTOS report.	"T","F"
reasoning	Optional	Object		Reasoning.	Refer to explanation below.
recommendation	Yes	String	1	Recommendation.	"Accept","Reject","Manual"
threshold	Optional	String	4	Threshold.	"49"
riskScore	Optional	String	4	Risk score.	"10"

Object: reasoning

Field Name	Required	Type	Length	Description	Example
rulesEvaluated	Yes	Object		Rules Evaluated.	Refer to explanation below.
reEvaluate	Yes	String	1	Reevaluate.	"T","F"

Object: rulesEvaluated

Field Name	Required	Type	Length	Description	Example
result	Optional	String	8	Result.	"PASS","FAIL", "MANUAL", "Error"
weight	Optional	String	4	Weight.	"0"
ruleId	Optional	String	16	Rule ID.	"BLK01"
ruleDescription	Yes	String	128	Rule description.	"Check for any blacklist reference"

Example Message

Request

/personreevaluate GET Request

curl -X GET "https://xxx.finexusgroup.com/ACDD/rest/v1/personreevaluate?source=FNXCRDS&partnerId=bsss&productType=loanapplication&reference=2003160192931&apiVersion=1.3&referenceId=2003160192931&language=en&apiKey=123-KEJRU-001" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 

Response

/personreevaluate GET Response

{
   "status":{
      "sourceInfo":{
         "source":"FNXCRDS",
         "partnerId":"BSSS",
         "productType":"BSSS01",
         "reference":"50074154501001",
         "apiVersion":"1.2",
         "apiKey":"123KEJRU001",
         "referenceId":"50074154501001"
      },
      "errorList":[
         {
            "msgText":"Re-evaluation unsuccessfully retrieved.",
            "msgCode":"404"
         }
      ],
      "status":"SUCCESS"
   },
   "payload":{
      "highriskCountry":"F",
      "blacklistReport":"F",
      "scReport":"F",
      "maccReport":"F",
      "bnmReport":"F",
      "kdnReport":"F",
      "unscReport":"F",
      "ofacReport":"F",
      "ctosReport":"F",
      "reasoning":{
         "rulesEvaluated":[
            {
               "result":"Error",
               "weight":50,
               "ruleId":"FATF01",
               "ruleDescription":"Check for high-risk country"
            },
            {
               "result":"Error",
               "weight":50,
               "ruleId":"BLK01",
               "ruleDescription":"Check for any blacklist reference"
            },
            {
               "result":"PASS",
               "weight":0,
               "ruleId":"SC01",
               "ruleDescription":"Check for any security commission reports"
            },
            {
               "result":"PASS",
               "weight":0,
               "ruleId":"MACC01",
               "ruleDescription":"Check for any malaysian anti-corruption commission reports"
            },
            {
               "result":"PASS",
               "weight":0,
               "ruleId":"BNM01",
               "ruleDescription":"Check for any malaysian national bank reports"
            },
            {
               "result":"PASS",
               "weight":0,
               "ruleId":"KDN01",
               "ruleDescription":"Check for any ministry of home affairs reports"
            },
            {
               "result":"FAIL",
               "weight":25,
               "ruleId":"UNSC01",
               "ruleDescription":"Check for any united nation security council reports"
            },
            {
               "result":"FAIL",
               "weight":21,
               "ruleId":"OFAC01",
               "ruleDescription":"Check for any office of foreign assets control reports"
            },
            {
               "result":"PASS",
               "weight":15,
               "ruleId":"PRE01",
               "ruleDescription":"Check for pre-approval recommendation"
            },
            {
               "result":"PASS",
               "weight":0,
               "ruleId":"CS01",
               "ruleDescription":"Check for any CTOS reports"
            }
         ],
         "reEvaluate":"T"
      },
      "recommendation":"Manual",
      "threshold":49,
      "riskScore":10
   }
}