检查组织

/checkorgcdd

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

信息

这种方法允许提交请求，以便根据规定的CDD（客户尽职调查）规则检查是否接受一个组织作为客户。

回应将包括：

• 是否接受该组织作为客户的建议。
• 导致建议的CDD规则评估。
• 在评估中使用的任何负面参考报告均可提取。

请求

请求参数

字段名	必需	类型	长度	描述	示例
sourceInfo	是	对象		来源信息。	参阅下文说明。
interactionMode	是	对象		交互模式。	参阅下文说明。
language	可选	字符串	2	语言。	"en"，"ms"
purpose	是	字符串	128	用途。	"BASIC"，"ENHANCE"
organisation	是	对象		组织。	参阅下文说明。
email	可选	字符串	256	组织的电子邮件。	"abc123@email.com"
website	可选	字符串	256	组织的官方网站。	"www.website.com"
officeTelNo	可选	字符串	16	组织的办公电话号码。	"0821234567"
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"

对象: organisation

字段名	必需	类型	长度	描述	示例
legalForm	是	字符串	2	法律形式。	"HSBC0222"
legalName	是	字符串	128	法律名称。	"Berjaya Starbuicks Sdn Bhd"
bizName	可选	字符串	128	商业名称。	"Starbuicks Tea"
bizType	是	字符串	32	商业类型。	"Private Limited Company"
idNo	是	字符串	32	身份证号码。	"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	错误的请求。	N/A
401	未经授权的访问。	N/A
405	禁止访问。	N/A

响应参数

字段名	必需	类型	长度	描述	示例
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

字段名	必需	类型	长度	描述	示例
msgText	是	字符串	128	消息文本。	"Report unsuccessfully retrieved."
msgCode	是	字符串	8	消息代码。	"404"

对象：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"

请求

/checkorgcdd POST 请求

curl -X POST "https://xxx.finexusgroup.com/ACDD/rest/v1/checkorgcdd" \
 -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",
   "organisation":{
      "legalForm":"24",
      "legalName":"Berjaya Starbuicks Sdn Bhd",
      "bizName":"Starbuicks Tea",
      "bizType":"PLC",
      "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":"John Smith",
         "givenName":"John",
         "familyName":"Smith",
         "aliases":[
            "Johnnie Smith"
         ]
      }
   },
   "email":"abc123@email.com",
   "website":"www.website.com",
   "officeTelNo":"0821234567",
   "bankInfo":{
      "bankCode":"MAYBANK",
      "ownership":"I",
      "accountName":"MK Chan",
      "accountNo":"1340295020304"
   }
}'

响应

/checkorgcdd 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
      }
   }
}