Search in this section
Recommandation
For automated processing, we recommend using the XML email format. You can do this in the UserProfile/API Settings.
This QuickGuide will give you helpful tips how to parse replies from our API.
Introduction
An unmistakable order identifier must be generated in your own system and transferred to the XML interface as ctid. The order number is marked as transaction in the email response.
The important sections of the email response are highlighted red. These must be parsed to process the response.
An email consists of these blocks:
system | always |
reply | empty for “away”- messages |
nic_response | optional |
Details like status and transaction number are listed in the section system.
The details of the order are listed in the section reply.
The section nic response lists the detailed response from the registry, in which a detailed error message may also be included.
Generally, the status from the section system should be parsed, in order to decide which further details are needed to classify the order.
The following emails must be parsed:
DomainAway/AutoACK
AutoDNS confirmed an ongoing transfer with an ACK. (Only for gTLDs due to the IRTP Policy, normally there is a NACK).
<system> <reply> |
---|
Status S1403008 indicates that the domain name which was transferred away can be found with the keyword success_value.
Or an outgoing transfer has been confirmed by the NIC and the domain has been removed. E.g. from .AT or .EU.
<system> |
---|
In this case, the status indicates that the domain name that was transferred out is listed in the reply block. You must then remove it from your own system.
The registrar cannot interfere with this transfer – the domain owner can transfer out the domain without registrar approval.
Transfer AutoNACK
<system> |
---|
Transfer Reminder
This notification is sent when an outgoing transfer has already been ongoing for a while. It serves as a reminder and can be used for monitoring, i.e. as a trigger for AUTONACKs.
<system> |
---|
Transfer Out Notification
The domain transfer has been started by another registrar.
<system> |
---|
Status S1403 indicates that the domain name can be found with success_value. This domain will be transferred out. A reply with ACK/NACK is possible.
Confirmation Emails for Domain Orders
Domain Create
Success
<system> |
---|
Failed
<system> |
---|
Status S0101 and E0101 indicate that the order number can be found in the transaction field.
Domain Update
Success
<system> |
---|
Failed
<system> |
---|
Status S0102 and E0102 indicate that the order number can be found in the transaction field. The update can be ignored if it happens without or with an unknown transaction number.
Success with Deletion of the AuthInfo
<system> |
---|
Domain Delete
Success
<system> |
---|
Failed
<system> |
---|
Status S0103 and E0103 indicate that the order number can be found in the transaction field.
Domain Update (AutoUpdate)
After a transfer, an AUTOUPDATE will be started. The transaction id is the same as with domain transfer. The AUTOUPDATE will update, if necessary, nameservers and other contacts.
Analogue parsing will follow after a domain update as above. If the AUTOUPDATE failed, the error messages will help you to see which problem had occurred.
<system> |
---|
If the OwnerC is imported during this step, the following notification is shown:
<system> |
---|
In this case, the message should not be ignored. You can readout the domain contact ID of the new OwnerC in the “reply” block:
<reply> </reply> |
---|
Domain Transfer ACK with OwnerC Import
Depending on the TLD, the OwnerC can also be imported directly with the ACK.
<system> |
---|
Domain Transfer ACK
<system> |
---|
Domain Transfer NACK
<system> |
---|
This NACK comes with the Status E0104001.