From HEXONET Wiki
(→Returned values) |
|||
| (2 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
{{Sidebar}} | {{Sidebar}} | ||
| − | '''.AU Validation Service for Natural Persons''' | + | <div style="font-size: 250%;">'''.AU Validation Service for Natural Persons'''</div><br/> |
| + | |||
| + | <div class="alerthexonet alerthexonet-error"> | ||
| + | IMPORTANT NOTICE<br /> | ||
| + | This service is currently not available through the Control Panel and it can only be ordered/managed via the API. You can use the API Commands below via the API Console available in the Control Panel to submit orders, though. We apologize for the inconvenience and hope to be able to offer this service through the Control Panel as well soon. | ||
| + | </div> | ||
= What is it = | = What is it = | ||
| Line 158: | Line 163: | ||
In case automated address validation should fail, Resellers can contact support providing proof that the address listed in the validation request is a 1:1 match to the Customer’s residential address. A copy of a utility bill or other document confirming the address should be provided, and the address listed on it MUST match exactly the one provided in the Validation request. | In case automated address validation should fail, Resellers can contact support providing proof that the address listed in the validation request is a 1:1 match to the Customer’s residential address. A copy of a utility bill or other document confirming the address should be provided, and the address listed on it MUST match exactly the one provided in the Validation request. | ||
| + | |||
| + | = Updating a validated contact handle = | ||
| + | Please note that while it is possible to update the details in a validated contact handle, this will cause the handle to lose its “validated” status. | ||
| + | |||
| + | If the handle is associated with domains that are coming up for renewal, or if the customer wishes to use them for new registrations or trades, a new validation request must be submitted which will be charged as a new request. | ||
Latest revision as of 16:37, 16 August 2022
IMPORTANT NOTICE
This service is currently not available through the Control Panel and it can only be ordered/managed via the API. You can use the API Commands below via the API Console available in the Control Panel to submit orders, though. We apologize for the inconvenience and hope to be able to offer this service through the Control Panel as well soon.
Contents |
[edit] What is it
With the release of second level .AU domains on Mar 24, 2022, private individuals will finally also have the opportunity to register any domain they like under .AU.
AuDA, however, requires all Registrars to validate the details of anyone applying for a .au domain “using Reliable and Independent Electronic Data or valid identity documents” before submitting their application to the Registry systems.
For Australian businesses, this type of validation is already built into the regular registration workflow, using the ABN/ACN numbers provided in the domain registration command.
As 2nd level .au domains are open also to Natural Persons, HEXONET will need to perform validation of the applicant’s details before submitting their orders to the Registry.
Unlike ABN/ACN numbers lookups, these checks are not free.
To meet the demand for .au registrations from private individuals, we have created this separate Verification service that Resellers can use to verify the details of their customers before submitting registration orders on their behalf.
The reason this was built as a separate product was to minimize the changes required to the existing .AU orders flows and to reduce impact of these changes on those Resellers that only work with business customers. Additionally, as each private customer only needs to be validated once regardless of the number of domains they wish to register, this was considered the most efficient way to offer this opportunity also to these customers.
[edit] Important things to keep in mind
- This verification is carried out on the customer’s Residential Address and a supported form of ID that will be checked using global databases (Equifax) and against the Document Verification Service offered by the Australian government.
- Access to this service is regulated through the terms posted on the HEXONET website.
- In particular, Resellers should pay close attention to the fact that explicit and informed consent to verify their personal details must be obtained (and properly tracked) from each customer. The consent can be recorded through a signed form or electronically (e.g. a check-box in the order flow) and proof of this consent must be presented by the Reseller upon request by HEXONET Resellers should keep a copy of the Customer’s consent for 6 months after submitting the request.
- All verification requests are a chargeable operation, regardless of whether the verification is successful or not: Resellers should carefully check the details collected and confirm with the customer that they are absolutely correct before submitting them.
- Each successful verification is valid for 6 months. A validated contact can be used for an unlimited number of registrations, owner changes and renewals during the period of validity. The reason for this limitation is that AuDA requires the Registrar to re-verify Registrant details when a domain is renewed: the limitation is in place to avoid that the same verification can be used both to register and then renew the same domain.
- For the same reason, we strongly recommend Resellers to encourage Registrants to register their .au domains for the maximum allowed period, to reduce the need to perform the verification again each year the domain comes up for renewal.
- It is possible to verify the same details multiple times. Each verification will be treated independently and charged accordingly. The main reason for this is to allow Resellers to re-verify an existing contact and update its “validated until” date even before the original date has passed.
[edit] How to use it
A validated contact is required to process the following types of .AU operations:
- Registration
- Trade (Owner change)
- Renewal
Our system will check the Contact Handle used as Registrant and confirm its verification status. If the Handle is not validated, or the verification has expired, the order will fail.
Please note that only the Registrant handle needs to be validated.
Resellers can verify existing Contact Handles or create a new one as part of the verification process. This operation can be performed through the API.
Resellers can also test this service through the HEXONET OTE system. Sample data is available for testing purposes, please reach out to support should you need to test your integration.
[edit] Supported document types
- Australian Citizenship
- Australian Citizenship by Descent
- Australian Driver's Licence
- Australian Passport
- Australian Visa
- Australian Birth Certificate
[edit] Fields mapping per ID Type
ID type | Required Fields |
Australian Citizenship | X-AU-OWNER-IDTYPE = 1 X-AU-OWNER-IDNUMBER = Regex: [A-Za-z0-9] |
Australian Citizenship by Descent | X-AU-OWNER-IDTYPE = 2 X-AU-OWNER-IDNUMBER = Regex: [A-Za-z0-9] |
Australian Driver's Licence | X-AU-OWNER-IDTYPE = 3 |
Australian Passport | X-AU-OWNER-IDTYPE = 4 |
Australian Visa | X-AU-OWNER-IDTYPE = 5 |
Australian Birth Certificate | X-AU-OWNER-IDTYPE = 6 |
- X-AU-OWNER-DOB is always required. It should be filled in with the Registrant’s date of birth in the YYYY-MM-DD format.
- For Citizenship, the “X-AU-OWNER-IDDATE” should be filled in with the date in which Citizenship was acquired, as it appears in the Citizenship certificate.
[edit] Additional guidance on how to enter the ID data
[edit] Australian Citizenship
State | All |
Given Name(s) [firstname] | Required if available |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Stock (Document Number) | Required Stock Number field will permit entry of either; - the stock number (printed on the back top right hand corner) - the Citizenship Automated System (CAS) (prior to late-1998 printed on the front bottom left hand corner) - the evidence number (from late-1998 printed on the front) to be verified |
Acquisition Date | Required |
Additional Notes | Single name certificates should have the name entered into the Family Name field and the Given Name field left blank. |
Notes:
- It is only possible to validate Citizenship by Descent certificates issued from 1 July 2007.
[edit] Australian Citizenship by Descent
State | All |
Given Name(s) [firstname] | Required if available |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Stock (Document Number) | Required Prior to mid-2007 certificates contain a Register (maximum 4 digits) and Entry Number (maximum 5 digits) which combined make up the Stock (Document) Number value. From mid-2007 certificates are printed with a Client ID number (11 digits) which should be used for the Stock (Document) Number. |
Acquisition Date | Required |
Additional Notes | Single name certificates should have the name entered into the Family Name field and the Given Name field left blank. |
Notes:
- It is only possible to validate Citizenship by Descent certificates issued from 1 July 2007.
[edit] Australian Driver’s Licence
State | All |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Licence Number | Required |
State of Issue | Required |
Additional Notes | Single name licences should have the name entered into the Family Name field with a full stop or hyphen entered into the Given Name Field. Where a Given Name includes multiple names i.e. John James, the second name may represent a Middle Name and should not be entered. |
Notes:
- Expired licences cannot be verified.
- WA extraordinary licences cannot be verified.
- Apostrophes can be used but inverted commas will result in verifications failing.
- Middle name, if supplied, is not sent for verification.
- Card Number, if supplied, is sent for verification.
[edit] Passport
State | All |
Given Name(s) [firstname] | Required if available |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Document Number | Required |
Additional Notes | Given Name(s) field must include all first and middle names. Single name passports should have the name entered into the Family Name field with the Given Name field left blank. Family Name or Given Name(s) that are longer than 31 characters (including spaces) will record as many full names as possible in the respective fields with other names initialised. |
Notes:
- The following types of Australian travel documents can be verified; Passport (including Ordinary, Frequent traveller, Diplomatic, Official and Emergency).
- Provisional travel documents cannot be verified.
[edit] Visa
State | All |
Given Name(s) [firstname] | Required Should not include accents in name(s). |
Middle Name | N/A |
Family Name [lastname] | Required Should not include accents in name(s). |
Birth Date | Required |
Passport Number | Required |
Additional Notes | Single name passports should have the name entered into the Family Name field and the Given Name(s) field should contain a hyphen. If a successful match is not achieved using the biographic data from the main section of the passport, then the details as they appear in the Machine Readable Zone should be provided (as this does not include non-Latin and national characters). |
Notes:
- Foreign nationals that arrived in Australia prior to mid-1990 may not be able to be verified.
[edit] Australian Birth Certificate
State | ACT |
Registration State | Required |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates, where only a Given Name(s) or Family Name is printed must be entered with a hyphen in the empty name field. |
State | NSW |
Registration State | Required if available |
Given Name(s) [firstname] | Required if available |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates must have the name values entered into the corresponding name field and the empty field must contain a hyphen or be left blank. |
State | NT |
Registration State | Required |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates, where only a Given Name(s) or Family Name is printed must be entered with a hyphen in the empty name Field. Registration number cannot be used to verify Aboriginal Population Record certificates. If it is provided with the certificate number it will be Ignored. Certificate number must be provided to verify Aboriginal Population Record certificates. |
State | QLD |
Registration State | Required |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | single name certificates are not verifiable. Given & Middle Names may be required to be submitted together in the Given name field. |
State | SA |
Registration State | Required |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates, where only a Given Name(s) or Family Name is printed must be entered with a hyphen in the empty name field. |
State | TAS |
Registration State | Required |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates are not verifiable. If the time of birth is displayed on a certificate, it must be included as displayed in order to achieve a positive result. |
State | VIC |
Registration State | Required |
Given Name(s) [firstname] | Required if available |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates may be printed with a value denoting that the individual does not have a Given Name(s) or Family Name. Typically this will appear as ‘No Registered Surname’ or ‘No Registered Given Name’. If printed this value must be entered to achieve a positive result. Single name certificates may also be printed with a blank Given Name(s) or Family Name field; if there is no value printed on the certificate these can be verified by either entering a hyphen or leaving the field blank. |
State | WA |
Registration State | Required |
Given Name(s) [firstname] | Required |
Middle Name | N/A |
Family Name [lastname] | Required |
Birth Date | Required |
Additional Notes | Single name certificates will be printed as one name value rather than Given Name(s) and Family Name values. The data should be entered into the Given Name(s) |
Notes:
The following birth certificates can be verified;
- ACT where the certificate was issued after 01/01/1930 or those where data has been electronically captured
- NSW where the birth occurred after 01/01/1914 or those that have otherwise been electronically captured
- NT birth certificates, including Aboriginal Population Record certificates, where the certificate was issued after 01/01/1870 or those that have otherwise been electronically captured
- QLD where the birth was registered after 01/01/1941
- SA where the certificate was issued after 01/01/1944 or those that have otherwise been electronically captured
- TAS where the certificate was issued after 01/01/1970
- VIC birth certificates issued after 01/01/1929 or those that have otherwise been electronically captured
- WA where the certificate was issued on or after 01/01/1841.
The following birth certificates cannot be verified;
- NSW birth records occurring prior to 1952 that contain a district number only
- WA birth certificates issued in the Cocos Islands prior to 1955
- WA birth certificates issued by/in Christmas Island prior to 1 July 1993.
[edit] Ensuring a successful address validation
Resellers should ensure that the address provided is the Registrant’s current Residential address (e.g. the one that appears on utility bills) and that all names and addresses are spelled correctly to minimize the possibility of failed validation requests.
The following sources are used to populate the database. As long as the address provided matches the one listed in one of these services, the check should pass without problems:
- Electoral Roll (Historical)
- Credit Bureau Commercial
- Credit Bureau Public Record
- National Tenancy Database
- Equifax Phone Directory
- Phone Directory
Please note that the check performed on the address is not a credit check. Only the Credit Header is checked to match the Name & Address against the file.
In case automated address validation should fail, Resellers can contact support providing proof that the address listed in the validation request is a 1:1 match to the Customer’s residential address. A copy of a utility bill or other document confirming the address should be provided, and the address listed on it MUST match exactly the one provided in the Validation request.
[edit] Updating a validated contact handle
Please note that while it is possible to update the details in a validated contact handle, this will cause the handle to lose its “validated” status.
If the handle is associated with domains that are coming up for renewal, or if the customer wishes to use them for new registrations or trades, a new validation request must be submitted which will be charged as a new request.
[edit] API Commands
command = ValidateContact contact = (TEXT) (in case the Reseller wants to add validation to an existing handle rather than creating a new one) firstname = (TEXT) middlename = (TEXT) lastname = (TEXT) street0 = (TEXT) city = (TEXT) state = (TEXT) zip = (TEXT) country = (COUNTRY) (must be AU) phone = (PHONE) email = (EMAIL) REGISTRY = AU X-AU-OWNER-IDTYPE = [INT] (see list above) X-AU-OWNER-IDNUMBER = [TEXT] X-AU-OWNER-IDISSUER = [TEXT] X-AU-OWNER-IDDATE = YYYY-MM-DD X-AU-OWNER-DOB = YYYY-MM-DD X-AU-OWNER-ACCEPT-VALIDATION-TERMS = 1 (required. The regulation requires us to obtain explicit consent from the user to validate their data)
[edit] Returned values
property[x-au-validated] = [0|1] property[x-au-validated-until] = YYYY-MM-DD
