Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
nocode:identity-link [2019/08/13 05:55]
740803864 [Response processing]
nocode:identity-link [2019/08/13 11:20] (current)
740803864 [Positive response]
Line 6: Line 6:
 See chapters below for details. See chapters below for details.
  
-===== Set up =====+===== Setup =====
 At first, identity link must be prepared and sent to ADUCID Binder. ADUCID Binder accepts identity link HTTP requests at ''/​aducid-binder/​prepareIdentityLinkUpload''​. Before ADUCID Binder call, **unique identifier (aka ''​identityLinkId''​) must be generated**. This identifier is neccessary to successfully pair identity link request and response. Let's see ADUCID Binder identity link interface parameters: At first, identity link must be prepared and sent to ADUCID Binder. ADUCID Binder accepts identity link HTTP requests at ''/​aducid-binder/​prepareIdentityLinkUpload''​. Before ADUCID Binder call, **unique identifier (aka ''​identityLinkId''​) must be generated**. This identifier is neccessary to successfully pair identity link request and response. Let's see ADUCID Binder identity link interface parameters:
 ^ Name ^ Values ^ Mandatory ^ Description ^ ^ Name ^ Values ^ Mandatory ^ Description ^
Line 23: Line 23:
  
 ===== Identity link itself ===== ===== Identity link itself =====
-When identity link data are successfully uploaded, we can start identity link itself. It can be done with use of [[web-integration:​client-side|Client API for Web Integration]]. We only need to specify ADUCID Binder methods to serve identity link:+When identity link data are successfully uploaded, we can start identity link itself. It can be done with use of [[web-integration:​client-side|Client API for Web Integration]]. We only need to specify ​right ADUCID Binder methods to serve identity link:
  
 <code javascript>​ <code javascript>​
Line 39: Line 39:
  
 ==== Positive response ==== ==== Positive response ====
-See [[nocode:transactions#​positive_response|Transaction supportPositive ​response]] chapter.+When identity link was successful (''​status = OK''​),​ JSON response will be: 
 + 
 +<code javascript>​ 
 +
 +  "​status":​ "​OK"​, 
 +  "​data":​ null, 
 +  "​redirect":​ null 
 +
 +</​code>​ 
 + 
 +When ''​request''​ value was used in identity link setup (e.g. ''​{"​eidProviderMethod":"​READ_EID_USER_DATA","​data":​null}''​),​ ''​data''​ will be filled in service provider ​response. ​For example: 
 + 
 +<code javascript>​ 
 +
 +  "​status":​ "​OK",​ 
 +  "​data":​ { 
 +    "​firstName":​ "​John",​ 
 +    "​firstNameApproved":​ true, 
 +    "​lastName":​ "​Green",​ 
 +    "​lastNameApproved":​ true, 
 +    "​permanentAddress":​ "​Castle Road 54, Green Town, CF72 2YD",​ 
 +    "​permanentAddressApproved":​ true, 
 +    "​identityCardNumber":​ "​ID97967588",​ 
 +    "​identityCardNumberApproved":​ true, 
 +    "​identityCardValidTo":​ "​2023-05-10",​ 
 +    "​identityCardValidToApproved":​ true, 
 +    "​birthDate":​ "​1971-10-09",​ 
 +    "​birthDateApproved":​ true, 
 +    "​deliveryAddress":​ "​Castle Road 54, Green Town, CF72 2YD",​ 
 +    "​deliveryAddressApproved":​ true, 
 +    "​telephoneNumber":​ "+44 654 987 987",​ 
 +    "​telephoneNumberApproved":​ true, 
 +    "​voter":​ true, 
 +    "​voterApproved":​ true, 
 +    "​creditCardNumber":​ "4485 5057 0701 1520",​ 
 +    "​creditCardNumberApproved":​ true, 
 +    "​creditCardValidTo":​ "​09/​2022",​ 
 +    "​creditCardValidToApproved":​ true, 
 +    "​creditCardOwner":​ "John Green",​ 
 +    "​creditCardOwnerApproved":​ true, 
 +    "​gender":​ "​male",​ 
 +    "​genderApproved":​ true, 
 +    "​email":​ "​john.green@test.com",​ 
 +    "​emailApproved":​ true, 
 +    "​approvedLF":​ true, 
 +    "​proofingStatus":​ "​APPROVED"​ 
 +  }, 
 +  "​redirect":​ null 
 +
 +</​code>​
  
 ==== Negative response ==== ==== Negative response ====
 See [[nocode:​transactions#​negative_response|Transaction support, Negative response]] chapter. See [[nocode:​transactions#​negative_response|Transaction support, Negative response]] chapter.
  
  • nocode/identity-link.1565675746.txt.gz
  • Last modified: 2019/08/13 05:55
  • by 740803864