| Table of Contents |
|---|
Overall Outcome States
State Name | Meaning | Human Readable Name |
|---|---|---|
| VERIFIED | The individual has been verified against the specified rule set. | Verified |
| VERIFIED_ADMIN | The individual was manually verified by an administrator through the admin panel. | Verified (by admin) |
| VERIFIED_WITH_CHANGES | The individual was verified against the specified rule set, however some minor changes were made to the data in order to get the result. These changes are included in the rule set as acceptable changes. | Verified with changes |
| IN_PROGRESS | The individual has not yet been verified, but further checks may be attempted. As GreenID allows further checks to be performed at any time this can be considered as not yet meeting the rule set requirements for verification. | In progress |
| PENDING | The individual has been verified against the rule set, but to do so they changed data in a way that is not considered acceptable without further action. | Pending review |
| LOCKED_OUT | The individual has been locked out completely. This will occur depending on the customer lock out rules. By default there are no lock out rules. | Locked out |
Possible Modes
Mode name | Meaning | Human readable name |
|---|---|---|
POSTOFFICE | The individual was verified by filling out a Post Office form and visiting a branch of Australia Post where their identity documents were manually inspected. | Post Office |
ASSISTED | The user was verified by an administrator logging into the admin panel and entering the data on behalf of the user. This method still contacts the third party data sources to confirm the entered data. | Admin assisted |
EXTERNAL | This mode is used to indicate that verification was carried out outside of the greenID system, and the results have been loaded into greenID. | Externally Verified |
Individual Source States
State name | Meaning | Human readable name |
|---|---|---|
VERIFIED | The individual's data has been verified against this source | Verified |
VERIFIED_ADMIN | An administrative user has marked the check as successful, after manual inspection of the results. This mostly applies to checks that were previously “Pending review” (see below). | Verified (by admin) |
VERIFIED_WITH_CHANGES | The check against the data source passed, but the person made some changes to their details in order to pass. If the changes are acceptable according to the customer’s rules, then this state is applied; otherwise the status may remain as “PENDING”. | Verified with changes |
PASSED | Deprecated - refer to NOT_FOUND_ON_LIST
| Passed |
FAILED | This status applies to a source when the check has been unsuccessful - either the data has not matched or (in the case of some interactive checks) the user has changed some data violating the the requirements of the rules. For Watch Lists Deprecated - refer to FOUND_ON_LIST.
| Failed |
AUTOFAIL | Applies to background checks, and indicates that a check that was attempted automatically has failed, i.e. the check against the data source was not successful. | Autofail |
IN_PROGRESS | The check is currently in progress, i.e. the check has been started, but not enough data has been gathered to allow the check to be completed. | In progress |
PENDING | The check against the data source passed, but the person made some changes to their details in order to pass, and manual intervention is required to assess the changes. | Pending review |
LOCKED_OUT | Some data sources have a limited number of attempts associated with them, and if that threshold is exceeded, then the person is prevented from trying again. | Locked out |
ERROR | An error was experienced during the check, for example, the data source was unavailable. | Error |
| NOT_FOUND_ON_LIST | This state is specific to the watchlist checks. The person was NOT found on a watchlist. It indicates a non-suspicious result. | Not found on list |
| FOUND_ON_LIST | This state is specific to the watchlist checks. The person was found on the watchlist. | Found on list |
| EMPTY | Indicates this check has not been used. |
Method Names
Method name | Meaning | Human readable name |
|---|---|---|
| DB | This check was a “Data Base” check that was automatically carried out with no user input. This is also referred to as a “Non Consent check” as no explicit consent is needed from the user. | Data Base OR Non Consent |
| background | This is a pseudonym for DB. | |
| UC | The check was a “User Centric” check that required either input or explicit consent from the user or both. | User Centric |
| interactive | This is a pseudonym for UC. | |
| PP | This check was carried out as a “Person Present” or face to face check. The main example of this type of check is a Post Office verification where the user physically presented themselves and their verification information at a Post Office. | Person Present |
| A category that does not fall into the above will have a blank or null method name. | None |
Field Status
Status name | Meaning | Human readable name |
|---|---|---|
| CONFIRMED | This field was matched to this source exactly | Field confirmed. |
| CHANGED | This field was changed in order to get a valid match on this source | Field changed. |
| ADDITION | This was an additional field that was added by the user in order to get a valid verification. This is a specialised field that is only available to certain customers. By default a customer will never receive this. | Additional field. |
| NO_MATCH | This is a status returned by “DB” or non consent checks and indicates that a match was not able to found on the source. | No exact match found. |
| MISSING | This is a status returned by a “DB” or non consent source and indicates that this field was not available to be compared on the source, for example in the phone book check the givenName is most often MISSING, whereas the firstInitial is present. | Field missing on source. |
DateTime specification
If you are not programmatically consuming the WSDL but are instead constructing the xml by hand then the Date must be of xs:dateTime see http://www.w3.org/TR/xmlschema-2/#dateTime
.NET and Date Types
Please read this section if your development platform is .NET!
Another important note is how .NET treats date/time types. When JBoss generates the WSDL for GreenID’s Web Services, the type “xs:dateTime” is used to map the Java java.util.Date class. This is not a problem if a Java platform is used to consume the WSDL, but .NET will behave in a slightly unexpected way.
When the .NET platform consumes WSDL that contains a complex type with a member of the type xs:dateTime, the corresponding class generated by .NET will contain not only a member named as per the WSDL, but also a member of the same name, but with the word “Specified” appended to the name. This extra member is of the type boolean. When using the generated class, it is imperative that the “Specified” member be set to true, otherwise the date parameter received will be null, which will cause an exception to be thrown.
For example, the registerUser method (described below) takes a parameter which is of the complex type tns:registerUser, which contains a member called “dob” of the type xs:dateTime. The .NET platform will generate a class called registerUser which contains a member calleddob of the type dateTime, and will also generate a member called “dobSpecified”, which must be set to true, otherwise the field dob will be null when received by GreenID’s Web Service.
This note applies to applications written in C# or VB.
For further information, the reader is referred to http://msdn2.microsoft.com/en-us/library/ms973825.aspx, and in particular, the section http://msdn2.microsoft.com/en-us/library/ms973825.aspx#datetime_topic4.
Street Types
Street Types in Full
The following is the list of Australian street types that greenID will recognise:
...
WALK
WALKWAY
WAY
WHARF
WYND
YARD
Street Type Abbreviations
The following is a list of Australian street type abbreviations that greenID will recognise:
ACCS
ALLY
ALWY
AMBL
ANCG
APP
ARC
ART
AVE
BASN
BCH
BDGE
BDWY
BEND
BLK
BRAE
BRCE
BRK
BROW
BVD
BYPA
BYWY
CAUS
CCT
CDS
CH
CIR
CL
CLDE
CLT
CMMN
CNR
CNWY
CON
COVE
COWY
CPS
CRCS
CRD
CRES
CRSG
CRSS
CRST
CSO
CT
CTR
CTTG
CTYD
CUWY
DALE
DELL
DEVN
DIP
DR
DRWY
DSTR
EDGE
ELB
END
ENT
ESP
EST
EXP
EXTN
FAWY
FITR
FLAT
FOLW
FORM
FRNT
FRTG
FSHR
FTRK
FTWY
FWY
GAP
GDN
GDNS
GLD
GLEN
GLY
GR
GRA
GRN
GRND
GTE
GTES
HILL
HRD
HTS
HWY
INTG
INTN
JNC
KEY
LANE
LDG
LEES
LINE
LINK
LKT
LNWY
LOOP
LT
LWR
MALL
MEW
MEWS
MNDR
MT
MWY
NOOK
OTLK
PARK
PART
PASS
PATH
PDE
PHWY
PIAZ
PKLD
PKT
PKWY
PL
PLAT
PLZA
PNT
PORT
PROM
QDGL
QDRT
QUAD
QY
QYS
RAMP
RCH
RD
RDGE
RDS
RDSD
RDWY
RES
REST
RGWY
RIDE
RING
RISE
RMBL
RND
RNDE
RNGE
ROW
ROWY
RSBL
RTE
RTT
RTY
RUE
RUN
RVR
RVRA
RVWY
SBWY
SDNG
SHWY
SLPE
SND
SPUR
SQ
ST
STPS
STRA
STRP
STRS
SWY
TARN
TCE
THOR
TKWY
TLWY
TOP
TOR
TRI
TRK
TRL
TRLR
TURN
TWRS
UPAS
UPR
VALE
VDCT
VIEW
VLLS
VSTA
WADE
WALK
WAY
WHRF
WKWY
WYND
YARD