| Note | ||
|---|---|---|
| ||
There are currently two versions of the API in use: Version 2 and Version 3. Both versions are current, and there is no obligation for existing customers to migrate from Version 2 to Version 3. Read more under Versions of the API below. |
| Excerpt | ||
|---|---|---|
| ||
greenID API provides a web-service only interaction with greenID, allowing greenID to be embedded within a customer's website. |
...
Purpose of the API
To simplify the integration of greenID Web Services into customer applications, greenID provides a Web interface and a Mobile SDK. However, these solutions require that the person being verified be re-directed to greenID verification pages for the interactive portion of the verification process, and returned to the customer application when that process is completed. They may not be suitable for all customers, and the greenID API is designed to meet this need.
With the greenID API, greenID Web Services are fully integrated into the customer's application. Individuals being verified stay entirely within the customer's web site, i.e., they are never redirected to any greenID pages. The customer’s application makes Web Service calls to greenID and uses the results to drive the verification process. The integration effort will be higher, since customers aren't leveraging the existing greenID verification pages, but the trade-off is greater flexibility, customisability and control. The use of greenID becomes totally transparent to the person being verified.
Versions of the API
There are currently two versions of the API in use: Version 2 and Version 3. Both versions are current, and there is no obligation for existing customers to migrate from Version 2 to Version 3. Version 1 has been deprecated, and should not be used.
The main difference between Version 2 and Version 3 is that Version 3 is designed to work with combination sources, which are ID documents scanned using greenID Mobile. Version 2 does not adequately handle the more complex data structures used with combination sources, and Version 3 has been created to address those deficiencies. If you are using, or plan on using, greenID Mobile then you should use Version 3, otherwise you are free to use Version 2.
If you have any doubts of concerns about which environment or API version you should be using, please contact your greenID account manager.
Typical Use Case
At a high level, the process of verifying a person's identity follows these basic steps:
- Register a verification attempt with greenID. (Required) This establishes the "master record" in greenID, which is used throughout the rest of the verification process.
- Fetch the list of sources that can help verify a person’s identity. (Optional) Some customers will have fixed lists of data sources, however this step offers some additional flexibility to those customers who require it. This list is computed dynamically, depending on customer account configuration, the state of the verification attempt and the availability of data sources.
- Fetch the list of fields required for a particular data source. (Optional) After a data source has been chosen, the list of fields can be fetched. This step is optional, because the fields associated with a particular data source do not usually change. Once you know what they are, you can assume they will remain the same; this strategy is reasonable and will save on Web Service calls.
- Submit values for data fields to a particular data source. (Required) After the person being verified supplies values for required data fields, these items are submitted to greenID. The result indicates the outcome of the check, along with a complete snapshot of the state of the verification attempt, and a list of data sources that can help the person become verified (the same list that would be returned from Step 2, including the current state of attempts the person has made against any data sources).
- Repeat steps 3 and 4 until the verification process is complete. Keep in mind that Step 3 is optional. An alternative outcome is that the person abandons the verification process or chooses an offline option.
API Versions
| Current Version | Legacy Versions | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
The current version of the API is backward compatible with previous versions. Therefore you should use the current version, unless you have an application that was created using an earlier version and you have internal requirements that necessitate your continuing to use it. We have left documentation for earlier versions of the API in the Knowledge Base for the convenience of such customers.
Contents
| Child pages (Children Display) |
|---|