FAQ

Do you have a public API?

For questions regarding using API with #gandiv5, we recommend that you contact customer support.

At present we have the following public API:

  • XML/RPC API: You can use our legacy API for most operations, however note that it is incompatible with managing DNS records on domains using our LiveDNS, as well as GandiMail. Using this would imply some access and use of our classic website.
  • RESTful HTTP API: You can use our RESTful API with LiveDNS to manage your DNS records on domains using LiveDNS.

How do we handle non-payment by the customer?

And related: “How quickly do we need to ensure customer payment in order to be able to cancel and get a refund from you if the customer doesn’t pay?”

Some transactions (e.g. registrations of certain domains) are non-refundable once completed. Others can be cancelled and fully refunded within a specified time period (e.g. .com registrations can be cancelled up to day 5).

What is your refund policy?

We refund where the service was not delivered due to errors on our part, or where our policy specifically permits it (e.g. SSL certificates are refunded fully up to 60 days, no questions asked). For domain registrations, we refund where the registration can be cancelled (e.g. .com up to 5 days).

What happens if the domain is auto-renewed but the customer fails to pay us for the renewal?

The auto-renewal feature requires payment to complete, on Gandi’s side, and renewals cannot be refunded. The risk of non-payment must be borne by the reseller.

What Customer data do we need to pass to you? What data will we receive from you?

Gandi will require the contact information of the registrant. The mandatory parameters are:

  • street address
  • zip code
  • city
  • country
  • email
  • contact name (family, given)
  • a password for that account
  • phone number
  • contact type (company, individual)

Some extensions require additional parameters as well. See: http://doc.rpc.gandi.net/contact/reference.html#ExtraParameters

Parked pages – are there limitations on what we can choose to do with new domains and domains that don’t point to anything yet?

You may host a parking page that all domains registered via your site will point to by default (this will be done via a default zone file). There are content restrictions on certain domains, such as .cn, .xxx, or .cat.

How do you handle domain name disputes, locking, forced transfer, etc.?

Gandi maintains a legal desk, which handles all cases that require registrar involvement in disputes between third parties. In most cases the issue can be forwarded to legal@gandi.net for investigation and response. We are extremely cautious and careful when processing takedown requests, and strictly follow applicable due process.

Gandi also maintains an abuse desk, which handles disputes between Gandi and it’s customers (e.g. spammers, fraudulent registrations, etc.).

In the event that our reseller agreement expires or is terminated, what is the customer experience? What happens to the domains they purchased through our interface? How/where do they go to manage these?

By default, in such a case the ownership of the domains would remain with the customers. All the customer accounts would be released by you, and the customers would become direct Gandi customers. They would be directed to use the Gandi web site to manage their domains. Alternatives may be possible, should a third party become involved and wish to take over control of the accounts from you, for example

What tools, documentation, etc. can you provide to our support team?

We provide resellers access to our standard documentation, LiveDNS API, and legacy (v4) API. We also provide phone support for resellers.

What limits, throttling, or other capacity constraints do we need to be aware of for your reseller API?

For customers using our classic API, today we rate-limit accounts to 30 requests every 2 seconds. We can facilitate higher levels if needed.

How can I move a domain from my personal account or organization to my reseller organization?

Whether the domain is in your personal account or one of your organizations, to move it to be managed as a “customer” of your reseller organization, you must perform a domain transfer. During that operation, you will need to choose your reseller organization as the one to invoice. Then, our system will automatically add another step asking you to choose the owner of the domain (eg. your customer). Fill out the form with your customer’s information and submit. In this way you can create your customer’s account as you go, or use one that is already existing.