检查个人

/checkpersoncdd

Method : POST
URL : https://xxx.finexusgroup.com/acdd/rest/v1/checkpersoncdd

信息

这种方法允许提交请求，以便根据规定的CDD（了解客户）规则检查是否接纳某人作为客户。

回复将包括：

关于是否接受某人为客户的建议。
导致该建议的CDD规则评估。
用于评估的任何负面参考报告都可以检索。

请求
响应

请求参数

字段名	是否必填	类型	长度	描述	示例
`sourceInfo`	是	对象		来源信息。	参阅下文说明。
`interactionMode`	是	对象		交互模式。	参阅下文说明。
`language`	可选	字符串	2	语言。	"en", "ms"
`purpose`	是	字符串	128	目的。	"BASIC", "ENHANCE"
`applicantName`	是	对象		申请人姓名。	参阅下文说明。
`nationality`	是	字符串	2	国籍。	"SG"
`idDoc`	是	对象		身份证明文件。	参阅下文说明。
`dob`	是	字符串	16	出生日期。	"1975-01-25"
`gender`	是	字符串	2	性别。	"M", "F"
`email`	可选	字符串	256	电子邮件。	"mkchan88@gmail.com"
`race`	可选	字符串	64	种族。	"Chinese"
`address`	可选	对象		地址。	参阅下文说明。
`pob`	可选	对象		出生地。	参阅下文说明。
`homeTelNo`	可选	字符串	16	家庭电话号码。	"28760941"
`officeTelNo`	可选	字符串	16	办公电话号码。	"28760941"
`mobileNo`	可选	字符串	16	移动电话号码。	"28760941"
`employment`	可选	对象		就业详情。	参阅下文说明。
`bankInfo`	可选	对象		银行信息。	参阅下文说明。

对象: sourceInfo

字段名	是否必填	类型	长度	描述	示例
`source`	是	字符串	16	来源。	"FNXCRDS"
`partnerID`	是	字符串	128	合作伙伴ID。	"BSSS"
`productType`	是	字符串	128	产品类型。	"loanapplication"
`reference`	是	字符串	64	参考。	"50074154501001"
`apiVersion`	是	字符串	8	API版本。	"1.2"
`apiKey`	可选	字符串	64	API密钥。	"123KEJRU001"
`userId`	可选	字符串	32	用户ID。	"u125"
`userToken`	可选	字符串	64	用户令牌。	"Cb1sci18j2UvNLsq4"

对象: interactionMode

字段名	是否必填	类型	长度	描述	示例
`mode`	是	字符串	8	模式。	"SYNC", "ASYNC"
`callbackUrl`	可选	字符串	256	回调URL。	"www.google.com"

对象: applicantName

字段名	是否必填	类型	长度	描述	示例
`fullName`	是	字符串	128	全名。	"Hector Rafael"
`givenName`	可选	字符串	128	名字。	"Hector"
`familyName`	可选	字符串	128	姓氏。	"Rafael"
`aliases`	可选	字符串	128	别名。	"Hector"

对象: idDoc

字段名	是否必填	类型	长度	描述	示例
`idType`	是	字符串	32	证件类型。	"MYKAD", "PASSPORT", "UNID", "BCREGNO"
`idNo`	是	字符串	32	证件号码。	"1234567890"
`issuedByCountry`	可选	字符串	2	发证国家。	"MX"
`issuedDate`	可选	字符串	16	发证日期。	"2016-03-15"
`expiryDate`	可选	字符串	16	到期日期。	"2021-03-15"

对象: address

字段名称	是否必需	类型	长度	描述	示例
`addrLine1`	是	字符串	256	地址行1。	"No 1 Jalan Manis"
`addrLine2`	可选	字符串	256	地址行2。	"Taman Madu"
`addrLine3`	可选	字符串	256	地址行3。	"KL"
`city`	是	字符串	128	城市。	"Kuala Lumpur"
`state`	是	字符串	128	州/省。	"Selangor"
`country`	是	字符串	2	国家。	"SG"
`postcode`	是	字符串	16	邮政编码。	"50200"

对象: pob

字段名称	是否必需	类型	长度	描述	示例
`addrLine1`	是	字符串	256	地址行1。	"No 1 Jalan Manis"
`addrLine2`	可选	字符串	256	地址行2。	"Taman Madu"
`addrLine3`	可选	字符串	256	地址行3。	"KL"
`city`	是	字符串	128	城市。	"Kuala Lumpur"
`state`	是	字符串	128	州/省。	"Selangor"
`country`	是	字符串	2	国家。	"SG"
`postcode`	是	字符串	16	邮政编码。	"50200"

对象: employment

字段名称	是否必需	类型	长度	描述	示例
`employmentType`	是	字符串	128	就业类型。	"Employed", "Self-employed", "Unemployed"
`position`	可选	字符串	128	职位。	"Executive"
`income`	可选	字符串	12	收入。	"2500"
`duration`	可选	字符串	9	持续时间。	"2.5"
`employer`	可选	对象		雇主。	参阅下文说明。

对象: employer

字段名称	是否必需	类型	长度	描述	示例
`legalForm`	是	字符串	2	法律形式。	"HSBC0222"
`legalName`	是	字符串	128	法律名称。	"Berjaya Starbuicks Sdn Bhd"
`bizName`	可选	字符串	128	商业名称。	"Starbuicks Tea"
`bizType`	是	字符串	32	商业类型。	"Private Limited Company"
`idNo`	是	字符串	32	ID号码。	"948649-V"
`mcc`	有条件	字符串	4	商户类别代码。	"5812"
`countryDomicile`	可选	字符串	2	国家归属。	"SG"
`address`	是	对象		地址。	参阅下文说明。
`pic`	是	对象		负责人。	参阅下文说明。

对象: address

字段名称	是否必需	类型	长度	描述	示例
`addrLine1`	是	字符串	256	地址行1。	"No 1 Jalan Manis"
`addrLine2`	可选	字符串	256	地址行2。	"Taman Madu"
`addrLine3`	可选	字符串	256	地址行3。	"KL"
`city`	是	字符串	128	城市。	"Kuala Lumpur"
`state`	是	字符串	128	州/省。	"Selangor"
`country`	是	字符串	2	国家。	"SG"
`postcode`	是	字符串	16	邮政编码。	"50200"

对象: pic

字段名称	是否必需	类型	长度	描述	示例
`fullName`	是	字符串	128	全名。	"Hector Rafael"
`givenName`	可选	字符串	128	名字。	"Hector"
`familyName`	可选	字符串	128	姓氏。	"Rafael"
`aliases`	可选	字符串	128	别名。	"Hector"

对象: bankInfo

字段名称	是否必需	类型	长度	描述	示例
`bankCode`	是	字符串	16	银行代码。	"HSBC0222"
`accountNo`	可选	字符串	32	账号。	"1340295020304"
`accountName`	可选	字符串	128	账户名称。	"Chan Mun Kit"
`ownership`	可选	字符串	1	所有权。	"I","J"

响应代码

响应代码	描述	响应模式
200	允许。	CDDPostResponse
400	错误请求。	NIL
401	未经授权的访问。	NIL
405	禁止访问。	NIL

响应参数

字段名称	是否必需	类型	长度	描述	示例
`status`	是	对象		状态。	参阅下文说明。
`payload`	可选	对象		CDD 结果。	参阅下文说明。

对象: status

字段名称	是否必需	类型	长度	描述	示例
`sourceInfo`	是	对象		来源信息。	参阅下文说明。
`errorlist`	是	对象		错误列表。	参阅下文说明。
`status`	是	字符串	16	状态。	"SUCCESS", "QUEUED", "FAIL"

对象: sourceInfo

字段名称	是否必需	类型	长度	描述	示例
`source`	是	字符串	16	来源。	"FNXCRDS"
`partnerID`	是	字符串	128	合作伙伴 ID。	"BSSS"
`productType`	是	字符串	128	产品类型。	"loanapplication"
`reference`	是	字符串	64	参考。	"50074154501001"
`apiVersion`	是	字符串	8	API 版本。	"1.2"
`apiKey`	可选	字符串	64	API 密钥。	"123KEJRU001"
`userId`	可选	字符串	32	用户 ID。	"u125"
`userToken`	可选	字符串	64	用户令牌。	"Cb1sci18j2UvNLsq4"

对象: errorList

字段名称	是否必需	类型	长度	描述	示例
`msgCode`	是	字符串	9	消息代码。	"000"
`msgText`	是	字符串	128	消息文本。	"Missing Parameter"

对象: payload

字段名称	是否必需	类型	长度	描述	示例
`highriskCountry`	是	字符串	2	高风险国家。	"T", "F"
`blacklistReport`	是	字符串	2	黑名单报告。	"T", "F"
`scReport`	是	字符串	2	证券委员会报告。	"T", "F"
`maccReport`	是	字符串	2	马来西亚反贪污委员会报告。	"T", "F"
`bnmReport`	是	字符串	2	马来西亚国家银行报告。	"T", "F"
`kdnReport`	是	字符串	2	国内事务部报告。	"T", "F"
`unscReport`	是	字符串	2	联合国安全理事会报告。	"T", "F"
`ofacReport`	是	字符串	2	外国资产控制局报告。	"T", "F"
`ctosReport`	是	字符串	2	CTOS报告。	"T", "F"
`reasoning`	可选	对象		推理。	参阅下文说明。
`recommendation`	是	字符串	1	建议。	"Accept","Reject","Manual"
`threshold`	可选	字符串	4	阈值。	"49"
`riskScore`	可选	字符串	4	风险评分。	"10"

对象: reasoning

字段名称	是否必需	类型	长度	描述	示例
`rulesEvaluated`	是	对象		规则评估。	参阅下文说明。
`reEvaluate`	是	字符串	1	重新评估。	"T","F"

对象: rulesEvaluated

字段名称	是否必需	类型	长度	描述	示例
`result`	可选	字符串	8	结果。	"PASS","FAIL", "MANUAL", "Error"
`weight`	可选	字符串	4	权重。	"0"
`ruleId`	可选	字符串	16	规则ID。	"BLK01"
`ruleDescription`	是	字符串	128	规则描述。	"Check for any blacklist reference"

示例消息

请求
响应

/checkpersoncdd POST 请求
curl -X POST "https://xxx.finexusgroup.com/ACDD/rest/v1/checkpersoncdd" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
        "sourceInfo": {
            "source": "FNXCRDS",
            "partnerId": "BSSS",
            "productType": "Credit Card",
            "reference": "2003160192931",
            "apiVersion": "1.2",
            "apiKey": "123-KEJRU-001",
            "userId": "mkchan",
            "userToken": "APPOKJSID8J1234"
        },
        "interactionMode": {
            "mode": "SYNC",
            "callbackURL": "www.abc.com"
        },
        "language": "en",
        "purpose": "ENHANCE",
        "applicantName": {
        "fullName": "Hector Rafael",
        "givenName": "Hector",
        "familyName": "Rafael",
        "aliases": ["Hector"]
        },
        "idDoc": {
            "idType": "MYKAD",
            "idNo": "1234567890",
            "issuedByCountry": "MX",
            "issuedDate": "2016-03-15",
            "expiryDate": "2021-03-15"
        },
        "nationality": "SG",
        "dob": "1975-01-25",
        "gender": "M",
        "race": "Chinese",
        "email": "mkchan88@gmail.com",
        "address": {
            "addrLine1": "No 1 Jalan Manis",
            "addrLine2": "Taman Madu",
            "addrLine3": "KL",
            "city": "Kuala Lumpur",
            "state": "Selangor",
            "country": "SG",
            "postcode": "50200"
        },
        "pob": {
            "addrLine1": "No 1 Jalan Manis",
            "addrLine2": "Taman Madu",
            "addrLine3": "KL",
            "city": "Kuala Lumpur",
            "state": "Selangor",
            "country": "SG",
            "postcode": "50200"
        },
        "homeTelNo": "28760941",
        "officeTelNo": "28760941",
        "mobileNo": "28760941",
        "employment": {
            "employmentType": "Employed",
            "position": "NRIC",
            "duration": "2.5",
            "income": "2500",
            "employer": {
                "legalForm": "HSBC0222",
                "legalName": "Berjaya Starbuicks Sdn Bhd",
                "bizName": "Starbuicks Tea",
                "bizType": "Private Limited Company",
                "idNo": "948649-V",
                "mcc": "5812",
                "countryDomicile": "SG",
            "address": {
                    "addrLine1": "No 1 Jalan Manis",
                    "addrLine2": "Taman Madu",
                    "addrLine3": "KL",
                    "city": "Kuala Lumpur",
                    "state": "Selangor",
                    "country": "SG",
                    "postcode": "50200"
                },
                "pic": {
                    "fullName": "Hector Rafael",
                    "givenName": "Hector",
                    "familyName": "Rafael",
                    "aliases": ["Hector"]
                }
            }
        },
        "bankInfo": {
            "bankCode": "HSBC0222",
            "accountNo": "1340295020304",
            "accountName": "Chan Mun Kit",
            "ownership": "I" 
        }
}
'

/checkpersoncdd POST 响应
{
     "status":{
            "sourceInfo": {
                "source": "FNXCRDS",
                "partnerId": "BSSS",
                "productType": "BSSS01",
                "reference": "50074154501001",
                "apiVersion": "1.2",
                "apiKey": "123KEJRU001",
                "referenceId": "50074154501001",
        },
        "errorList": [
          {
             "msgText": "Report unsuccessfully retrieved.",
             "msgCode": "404"
          },
        ],
        "status": "SUCCESS"
    },
    "payload": {
        "status": {
            "sourceInfo": {
                "source": "FNXCRDS",
                "partnerId": "BSSS",
                "productType": "BSSS01",
                "reference": "50074154501001",
                "apiVersion": "1.2",
                "apiKey": "123KEJRU001",
                "userId": "u125",
                "userToken": "Cb1sci18j2UvNLsq4"
            },
            "errorList": [
                {
                    "msgText": "Report 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": "FAIL",
                        "weight": 50,
                        "ruleId": "FATF01",
                        "ruleDescription": "Check for high-risk country"
                    },
                    {
                        "result": "FAIL",
                        "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": "F"
            },
            "recommendation": "Accept",
            "threshold": 49,
            "riskScore": 0
        }
    }
}

检查个人

/checkpersoncdd​

请求参数​

对象: sourceInfo​

对象: interactionMode​

对象: applicantName​

对象: idDoc​

对象: address​

对象: pob​

对象: employment​

对象: employer​

对象: address​

对象: pic​

对象: bankInfo​

响应代码​

响应参数​

对象: status​

对象: sourceInfo​

对象: errorList​

对象: payload​

对象: reasoning​

对象: rulesEvaluated​

示例消息​

与我们联系

/checkpersoncdd

请求参数

对象: sourceInfo

对象: interactionMode

对象: applicantName

对象: idDoc

对象: address

对象: pob

对象: employment

对象: employer

对象: address

对象: pic

对象: bankInfo

响应代码

响应参数

对象: status

对象: sourceInfo

对象: errorList

对象: payload

对象: reasoning

对象: rulesEvaluated

示例消息