China ID Verification

verifies input data from the resident identity card issued by the ministry of public security of china mandatory identity document for all chinese citizens aged 16 and above for authorization get session token from authentication page { "name" "china id verification", "method" "post", "url" "https //idu test datazoo com/api/v2/verify", "description" "name in native script name input should be given in chinese characters (hanzi) \n\n verification outcome – returns kyc verification\n consumer consent – yes\n mandatory input – name, dob and resident id card\n verifies – name, dob and id card\n returned data gender, address and identity of the data source", "tab" "examples", "examples" { "languages" \[ { "id" "f2jmy98siubrop0bgc788", "language" "curl", "code" "curl location 'https //idu test datazoo com/api/v2/verify' \\\\\n header 'content type application/json' \\\\\n header 'authorization bearer eyjhbgcioijiuzuxmiisinr5cci6ikpxvcj9 eyjpc3mioij0zxn0iiwiawf0ijoxnzqxodm2ntm2lcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju1ndgwotgsimv4cci6mtc0mtg2ntmzniwiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq 9rh 3kpgyholkywybfguaaouskhnzpyg pdogxm5eva6u4amsi aapeajfxdlea7hvnq1uuw1buv1yu0j9odlq' \\\\\n data '{\n \\"countrycode\\" \\"chn\\",\n \\"service\\" \[\n \\"china id verification\\"\n ],\n \\"clientreference\\" \\"test 0001\\",\n\t\\"fullname\\" \\"黄俊龙\\",\n \\"dateofbirth\\" \\"1988 07 22\\",\n \\"identityvariables\\" {\n \\"idcardno\\" \\"422822198807221014\\"\n },\n \\"consentobtained\\" {\n \\"china id verification\\" true\n }\n}'", "customlabel" "" } ], "selectedlanguageid" "f2jmy98siubrop0bgc788" }, "results" { "languages" \[ { "id" " kllvb jxqiuu wuwqaf", "language" "200", "customlabel" "", "code" "{\n \\"countrycode\\" \\"china\\",\n \\"clientreference\\" \\"test 0001\\",\n \\"reportingreference\\" \\"dz fab9ec86 d9aa 4a4f 8be3 a2530696545c\\",\n \\"matchstatus\\" \\"full match 1+1 verification\\",\n \\"searcherrormessage\\" \\"\\",\n \\"safeharbour\\" false,\n \\"searchstatus\\" \\"successful\\",\n \\"serviceresponses\\" {\n \\"china id verification\\" {\n \\"status\\" 0,\n \\"sourcestatus\\" \\"successful\\",\n \\"errormessage\\" \\"\\",\n \\"identityverified\\" true,\n \\"safeharbourscore\\" \\"l2\\",\n \\"namematchscore\\" \\"1 000\\",\n \\"addressmatchscore\\" \\"n/a\\",\n \\"verifications\\" {\n \\"dateofbirth\\" true,\n \\"fullname\\" true,\n \\"idcardno\\" true\n },\n \\"returneddata\\" {\n \\"address\\" \\"\\",\n \\"gender\\" \\"\\",\n \\"source\\" \\"dz4\\"\n }\n }\n },\n \\"remarks\\" \[]\n}" }, { "id" "as5tj4glqvhlg7b69q21j", "language" "404", "customlabel" "", "code" "{\n \\"message\\" \\"ain't no cake like that \\"\n}" } ], "selectedlanguageid" " kllvb jxqiuu wuwqaf" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[ { "name" "authorization", "kind" "required", "type" "string", "description" "sessiontoken obtained via the authentication call", "" "sessiontoken obtained via the authentication call" } ], "bodydataparameters" \[ { "name" "data", "kind" "required", "type" "object", "description" "request body sent to the api", "" "request body sent to the api", "children" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "chn" }, { "name" "service", "kind" "required", "type" "string", "description" "china id verification" }, { "name" "fullname", "kind" "required", "type" "string", "description" "the full name of the identity owner format is surname (last name) + first name" }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format\n \[see the note below regarding the optional dob input]" }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "idcardno", "kind" "required", "type" "string", "description" "national id number" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "name" "china id verification", "kind" "required", "type" "string", "description" "should be true" } ] } ], "schema" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "chn" }, { "name" "service", "kind" "required", "type" "string", "description" "china id verification" }, { "name" "fullname", "kind" "required", "type" "string", "description" "the full name of the identity owner format is surname (last name) + first name" }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format\n \[see the note below regarding the optional dob input]" }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "idcardno", "kind" "required", "type" "string", "description" "national id number" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "name" "china id verification", "kind" "required", "type" "string", "description" "should be true" } ] } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "response" \[ { "name" "countrycode", "kind" "optional", "type" "string", "description" "china", "children" \[] }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "the client reference (if given as input) ", "children" \[] }, { "name" "reportingreference", "kind" "optional", "type" "string", "description" "a reference number generated which is unique to each transaction ", "children" \[] }, { "name" "validationerrors", "kind" "optional", "type" "string", "description" "returned with http status code 400 when the request contains invalid or improperly formatted input data ", "children" \[] }, { "name" "matchstatus", "kind" "optional", "type" "string", "description" "\\"full match 1+1 verification\\" \n\\"no match\\" " }, { "name" "searcherrormessage", "kind" "optional", "type" "string", "description" "error message returned querying the data source", "children" \[] }, { "name" "safeharbour", "kind" "optional", "type" "boolean", "description" "true or false", "children" \[] }, { "name" "searchstatus", "kind" "optional", "type" "string", "description" "\\"successful\\" \n\\"not successful\\"", "children" \[] }, { "name" "serviceresponses", "kind" "optional", "type" "object", "description" "verification details with \\"china id verification\\" returned as the service identifier ", "children" \[ { "name" "status", "kind" "optional", "type" "integer", "description" "0 identityverified true element verifications all true\n1 identityverified true element verifications not all true\n2 identityverified false sourcestatus successful\n3 identityverified false sourcestatus not successful" }, { "name" "sourcestatus", "kind" "optional", "type" "string", "description" "\\"successful\\"\n\\"unsuccessful\\"" }, { "name" "errormessage", "kind" "optional", "type" "string", "description" "error message(s) from the data source example, \\"error querying data source\\" " }, { "name" "identityverified", "kind" "optional", "type" "boolean", "description" "true or false" }, { "name" "safeharbourscore", "kind" "optional", "type" "string", "description" "m2, l2 or m3\n for more information, refer to safe harbour scores page" }, { "name" "namematchscore", "kind" "optional", "type" "string", "description" "\\"1 000\\" matched \n\\"0 000\\" no match" }, { "name" "addressmatchscore", "kind" "optional", "type" "string", "description" "\\"n/a\\"" }, { "name" "verifications", "kind" "optional", "type" "object", "description" "element level verification returned as true or false", "children" \[ { "name" "dateofbirth", "kind" "optional", "type" "boolean", "description" "" }, { "name" "fullname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "idcardno", "kind" "optional", "type" "boolean", "description" "" } ] }, { "name" "returneddata", "kind" "optional", "type" "object", "description" "returns additional data from the data source ", "children" \[ { "name" "address", "kind" "optional", "type" "string", "description" "address returned from the data source" }, { "name" "gender", "kind" "optional", "type" "string", "description" "gender of the individual" }, { "name" "source", "kind" "optional", "type" "string", "description" "identifies the data source used " } ] } ] }, { "name" "remarks", "kind" "optional", "type" "array", "description" "null", "children" \[] } ] } date of birth input in the api call, the date of birth input can be omitted or set as optional based on the configuration in the client's account settings links