#### About New Zealand Plug-in

The InternetNZ plug-in is a HTTPS gateway communicating with digitally signed XML messages between HSPcomplete domain objects and InternetNZ Registry.

Domain registration

When domain registration is requested for the Provider account, an XML form is immediately sent to InternetNZ, and the response from InternetNZ server is received and processed right away. The ordered domain appears in the domains list in Provider Control Center and as soon as a successful registration response arrives from InternetNZ, the domain status becomes 'Registered'.

For domains which are ordered from your online store (or registration is requested from Provider Control Center for one of your customer accounts) the registration procedure is almost the same, however the domain registration request will be sent to InternetNZ only after the corresponding order is paid.

If there have been any errors in request, the domain status becomes 'Error'. In this case, you can turn to the Action Log in Provider Control Center and look for the corresponding record, which will help you to analyze the source of problem.

In case of successful registration InternetNZ register assigns UDAI ID to a domain. HSPcomplete saves UDAI ID in domain 'General Information' 'Registrar order' field. Customer can see it at domain details page, and it is to be used for future domain transfer, once customer decides to transfer from your Registrar.

Domain transfer

InternetNZ service currently supports domain transfer.

When domain transfer is requested for the Provider account, an XML form is immediately sent to InternetNZ, and the InternetNZ server response is received and processed right away. When a successful transfer response arrives from InternetNZ, the domain status becomes 'Transferring'. In case there have been any errors in the request, the domain status becomes 'Error'. You can analyze the source of problem with the help of an appropriate record in Action Log.

The InternetNZ plug-in periodically checks the status of the domain being transferred. Thus, when a domain is successfully transferred on the InternetNZ side, HSPcomplete gets this information and domain status becomes 'Registered'. In case any errors occur while domain transferring (e.g., rejected or denied), HSPcomplete gets this information and domain status becomes 'Error'.

Domain UDAI ID is required to perform domain transfer. HSPcomplete prompts user for this ID, and sends it to InternetNZ register. UDAI ID is changed/assigned to domain in these cases:

- new domain is registered;
- domain is transferred;
- domain registrant name is changed.

InternetNZ plugin always saves new UDAI ID in domain record Registrar order field, as well as ID of Transaction, by which this UDAI modification was done. You can validate UDAI at Service Director > Domain Manager > Setup > InternetNZ > Domain Query page, it's one of available functions. If UDAI ID is not valid, just change it by modifying registrant name at Service Director > Domain Manager > Domains > <a domain> > Whois/Contacts Info by updating Organization name field in Responsible person Contact section. Then new UDAI will appear in domain details Registrar order field.

In case of a successful transfer InternetNZ register returns new Domain UDAI ID. HSPcomplete saves UDAI ID in the 'Registrar order' field of the domain's 'General Information' page.

Domain Modification

Name servers synchronization and Whois/Contacts modification are available now with the InternetNZ plug-in.

Domain Renewal

InternetNZ supports automated domain registration renewals. Depending on the subscription renewal options, this operation can be performed automatically or manually with an appropriate button in the Domain subscription properties.

Domain Cancellation

Upon domain subscription termination InternetNZ plug-in sends request for domain cancellation to InternetNZ server as well. In HSPc 3.2 it's done by setting a script action on subscription cancellation event. This event setup is taking place during plug-in installation. In HSPcomplete 3.3 domain cancellation will be one of regular plug-in actions.

Additional Domain Actions

Some additional actions, namely obtaining domain details, cancelling, uncancelling, delegating and undelegating are available at Service Director > Domain Manager > Setup > InternetNZ page, Domain Query button. Here is a detailed description of these actions:

- Domain Details. By 'Domain Details' query some useful information can be obtained, e.g. domain status, expiration date, cancellation date, etc.
- Cancel. By this action the domain can be deleted from the registrar's and HSPC databases.
- UnCancel. This action restores the cancelled domain. Mind that the action is effective only within a month after the domain has been cancelled.

  Note: Uncancelling restores a domain solely at the registrar's side. To restore the domain in the HSPcomplete, use the Add registered domain option at the Service Director > Domain Manager >Domains, the New Domain button, press the Register/Transfer button and select the Register domain in registrar manually option.

- Delegate. The action triggers issuing the domain administration rights to the person/organization.
- UnDelegate. By undelegating the domain, its administration rights are cancelled.

Messages Polling

Once a day InternetNZ plug-in polls messages from the InternetNZ server.

These messages are related to actions which are applied to your registrar account or to your domains by someone else, as for Registry itself, or other registrars. The only action other registrars can do to your domains is transfer, so, getting these messages, you will know if a domain is transferred from your registrar. Registry is authorized to do any action to your account, as domain lock, update registrar permissions, etc.

If any action has been done to your account during last 24 hours, polling result will be sent to a certain email address, which you can enter in InternetNZ plugin configuration, 'Email for receiving polling messages' field.

Please send us your feedback on this help page