Retrieving the Verification State

greenID has a web service method that returns the verification details for an individual. getVerificationResult can be called at any time after a person has been registered to return the current verification details for a person.

Verification results are returned in a complex SOAP type called RichVerificationResult this structure contains information about whether a person has completed their online verification, and if so, whether the verification was successful, and any changes to the original data supplied that were made during the verification process. 

getVerificationResult

Method Summary

The getVerificationResult method is used by a client application to determine whether a given user has completed their verification process, and if so, what the outcome was. The original data as well as differences between the original data and the data that was actually verified are also included.

Method Signature

VerificationResult getVerificationResult( String customerId,  
          String userId)

Parameters


Name

Type

Required?

Description 

customerId

 


String

255 Chars

Yes

 


This parameter is GreenID's identifier for the client application. The value is supplied by GreenID, and must be included with each registration request.

 


userId

 


String

255 Chars

Yes


This parameter is an identifier that the client uses for the individual being verified. GreenID does not use it as an identifier, but in order to easily locate individual's for a particular client application, the userId is used. This must match a registered userId


Return Value

Faults

This method may raise a FaultDetails, inside which can be the following codes: 

  • InvalidCustomerIdFault
  • UserIdNotFoundFault
  • InvalidCertificateException
  • SystemFault