registerVerificationAndGenerateHostedInviteURL
This method checks that the input account is enabled for Hosted, performs a registration/validation using the input details and then will prepare a link to the hosted site for the account and return the link in the API response.
SOAP
Input Parameters
Field Name | Type | Required | Restrictions |
---|---|---|---|
accountId | String | Yes | GreenID issues each customer with an accountId, which is a unique identifier by which greenID knows the caller. This |
password | String | Yes | Each customer is issued a password that must be supplied with every call to any web method in the API. |
verificationId | String | No (may be null) | Each verification attempt for a person must have a |
ruleId | String | No (may be null) | Callers have a specific rule configured for their greenID Hosted account. This string must identify a rule. Contact greenID for the name of the rule configured for your Hosted account. If only one rule is configured, then the string “default” will automatically select that rule. |
name | Name | Yes |
|
currentResidentialAddress | Address | No (may be null) |
|
dob | DateOfBirth | Yes | Must be a valid date in the past. |
mobilePhone | String | No (may be null) | |
String | No (may be null) | Must be a valid email address following standard email validation rules and checking Top Level Domain (TLD) is valid. See https://data.iana.org/TLD/tlds-alpha-by-domain.txt | |
extraData | List <NameValuePair> | No | This parameter 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. |
For further information on the data structures used in this API please refer to Data Structures V3.
Return Values
The API call returns a GreenIDHostedServiceResult containing the following data:
Field Name | Type | Description |
---|---|---|
verificationId | String |
|
overallVerificationStatus | String | The overall status of the verification. |
hostedInviteUrl | String | ShortUrl generated for this registration for this call. |
responseErrorFlag | Boolean | True = an error occurred |
responseErrorMessage | String | A message providing information regarding the error that occurred. |
errorReasonCode | String | Indicates the type of error that occurred. |
Sample SOAP Request and Response
JSON
Input Parameters
Field Name | Type | Required | Restrictions |
---|---|---|---|
accountId | String | Yes | GreenID issues each customer with an accountId, which is a unique identifier by which greenID knows the caller. This |
password | String | Yes | Each customer is issued a password that must be supplied with every call to any web method in the API. |
verificationId | String | No (may be null) | Each verification attempt for a person must have a |
ruleId | String | No (may be null) | Callers have a specific rule configured for their greenID Hosted account. This string must identify a rule. Contact greenID for the name of the rule configured for your Hosted account. If only one rule is configured, then the string “default” will automatically select that rule. |
givenNames | String | Yes | Cannot be null. Cannot be the empty string. Max 255 characters. |
middleNames | String | No (may be null) | Max 255 characters. |
surname | Stromg | Yes | Cannot be null. Cannot be the empty string. Max 255 characters. |
country | String | No (may be null) | The country code. This must be the ISO 3166 country code. The country code can be given in either the alpha-2, alpha-3 or numeric format. Please refer to https://www.iso.org/obp/ui/#search for a full (and up to date) list of ISO 3166 country codes. |
postcode | String | No (may be null) | A 4 digit Australian postcode. |
state | String | No (may be null) | A valid abbreviation of an Australian state or territory, i.e. ACT, QLD, NSW, NT, SA, TAS, VIC or WA. |
streetName | String | No (may be null) | Max 255 characters. |
streetNumber | String | No (may be null) | Max 255 characters. |
streetType | String | No (may be null) | A valid street type abbreviation, e.g. “ST”, “RD” etc. |
suburb | String | No (may be null) | Max 255 characters. |
dob | DateOfBirth | Yes | Must be a valid date in the past. |
mobilePhone | String | No (may be null) | |
String | No (may be null) | Must be a valid email address following standard email validation rules and checking Top Level Domain (TLD) is valid. See https://data.iana.org/TLD/tlds-alpha-by-domain.txt |
For further information on the data structures used in this API please refer to Data Structures V3.
Return Values
The API call returns a GreenIDHostedServiceResult containing the following data:
Field Name | Type | Description |
---|---|---|
verificationId | String |
|
overallVerificationStatus | String | The overall status of the verification. |
hostedInviteUrl | String | ShortUrl generated for this registration for this call. |
responseErrorFlag | Boolean | True = an error occurred |
responseErrorMessage | String | A message providing information regarding the error that occurred. |
errorReasonCode | String | Indicates the type of error that occurred. |
smsID |
| This field should not be used in your implementation, it will be removed from the response soon. |
smsStatus |
| This field should not be used in your implementation, it will be removed from the response soon. |
Sample JSON Request and Response
Exceptions and Errors
Detailed Exception and Error information for SOAP and JSON for this method is available on https://vixverify.atlassian.net/wiki/spaces/GREEN/pages/2164129836.
Useful Links
On This Page
- 1.1 SOAP
- 1.1.1 Input Parameters
- 1.1.2 Return Values
- 1.1.3 Sample SOAP Request and Response
- 1.2 JSON
- 1.2.1 Input Parameters
- 1.2.2 Return Values
- 1.2.3 Sample JSON Request and Response
- 1.3 Exceptions and Errors
- 1.1 SOAP
- 2 Useful Links