Registering a user
iFrame Deprecated iFrame integration was deprecated in January 2015. New customers should integrate using either greenID Web or greenID API. Existing customers are encouraged to upgrade the integration method - contact support to find out more. This documentation remains to support existing customers with an iFrame integration.
Method Summary
The registerUser method is the first method that must be called when a verification of an individual is required (or one of the alternative methods described below). This method establishes a registration with greenID that can be used as the basis of further checks.
Some automatic (“non-consent”) checks, including Watchlist checks, can also be performed if the customer’s rules require it. The results of these checks will be returned in the RichVerificationResult object.
Method Signature
RichVerificationResult registerUser( String customerId, String userId, String ruleId, Name name, String email, AusAddress currentResidentialAddress, AusAddress previousResidentialAddress, Date dob, String homePhone, String workPhone, String mobile, nameValuePair[] extraData)
Parameters
Name | Type | Required? | Description | Contract |
---|---|---|---|---|
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. | Must be a valid identifier issued by GreenID. |
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 can be anything the client likes, and if it is not specified, then GreenID will issue an identifier. | May be any string, null or the empty string. If present, must be unique among all the users for a given client application. |
ruleId | String 255 Chars | Yes | Specifies the predefined verification rule that this registration will be run against. | Must be a string and must match a predefined rule string specified in the system. In almost all cases you should use the ruleId "default". Other values can only be used when your customer account has multiple rulesets configured for it. |
String 255 Chars | No | The user’s email address. | Must be a valid email address following the Standard Hibernate validation and checking Top Level Domain (TLD) is valid. See https://data.iana.org/TLD/tlds-alpha-by-domain.txt | |
address | AusAddress | Yes | A complex type encapsulating the user’s address. | Not null. There is a configuration option that can be used to make the address field optional for this web service call and/or the admin panel user registration screens. Let us know and we can configure this for your site. |
previousAddress | AusAddress | No | A complex type encapsulating the user’s previous address. | |
name | Name | Yes | A complex type encapsulating the user’s name. | Not null. |
dob | Date | No | The user’s date of birth. If present, the date must be in the past. If the DOB is missing, it is assumed that the person did not enter one. Any DOB supplied by the customer will be stored as the person’s DOB, therefore if the customer’s application provides a user with a default DOB if they don’t provide one, then passing that default DOB to GreenID is highly discouraged. | Null or in the past. See DateTime Specification within Reference Tables |
homePhone | String 255 Chars | No | The user’s home phone number. | No restrictions - non-digits are stripped when sent for verification checks. Please don't include country codes. |
workPhone | String 255 Chars | No | The user’s work phone number. | No restrictions |
mobile | String 255 Chars | No | The user’s mobile phone number. | No restrictions |
extraData | nameValuePair[] | No | This allows the customer to send extra data that will need to be agreed upon before implementation. It will be a simple key/value format. If there is no previous agreement for certain keys to be sent in this field then it will be ignored. |
Return Value
This method will return a RichVerificationResult object. This object is described in detail in the section on Outcome Notification, so the reader is referred to that section for further details. In summary, the return value will indicate the current status of the individual’s registration, and the outcome of any checks that were automatically performed.
If the userId has already been used then the saved result for the user represented by that ID will be returned, this will not re-run any validations checks.
Faults
This method may raise a FaultDetails, inside which can be the following codes:
- SystemFault
- InvalidCustomerIdFault
- InvalidCertificateException
This method may also raise a SystemFault.