Enregistrer un domaine (achat seul)

curl --request POST \
  --url https://kennhosting.com/api/v1/domains \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://kennhosting.com/api/v1/domains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://kennhosting.com/api/v1/domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://kennhosting.com/api/v1/domains"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://kennhosting.com/api/v1/domains")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Flux (API et espace client)

GET /v1/domains/quote : montant XAF pour domain + years.
POST /v1/domains : crée une commande order_type: standalone_domain en payment_required avec le contact registrant (aucun achat registrar avant paiement).
POST /v1/domain-orders/{order_uuid}/pay : initie le paiement Mobile Money (page de paiement hébergée) ; réponse avec checkout_url.
Après paiement (webhook) : enregistrement registrar, nameservers par défaut, commande active ; gestion DNS via les routes domains:dns.

Dans l’espace client : le flux principal passe par la page /domains (vérification + achat direct) ou via les liens contextuels vers /client/domains/purchase, puis redirige vers la fiche commande pour payer.

Distinction avec l’hébergement

Hébergement mutualisé : le domaine peut être inclus / provisionné via ProcessAutomatedOrder après paiement d’un plan d’hébergement : ce n’est pas ce flux.
Revendeur : pas d’achat de domaine client dans le job revendeur ; l’API domaine seul reste disponible si vous créez une clé avec les bons scopes.

`POST /v1/domains` : créer la commande

POST /v1/domains
Authorization: Bearer kh_live_xxxx
Content-Type: application/json
Accept: application/json

Corps JSON

{
  "domain": "monsite.com",
  "years": 1,
  "registrant": {
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean@example.cm",
    "phone": "+237677123456",
    "address": "BP 1234",
    "city": "Yaoundé",
    "state": "Centre",
    "postal_code": "00237",
    "country": "CM",
    "organization": "Mon Entreprise SARL"
  }
}

Champ	Type	Requis	Description
`domain`	string	Oui	Nom de domaine
`years`	integer	Non	1 à 10 (défaut 1)
`registrant`	object	Oui	Contact WHOIS (voir ci-dessous)

Le serveur recalcule le devis : le montant de la commande correspond au quote courant (pas de montant client dans le corps).

Objet `registrant`

Variantes acceptées : first_name / firstname, last_name / lastname, postal_code / postcode.

Champ	Requis
`email`, `phone`, `address`, `city`, `country`	Oui
Prénom / nom (une des variantes ci-dessus)	Oui
Code postal (une des variantes)	Oui
`state`, `organization`	Non

Réponse (succès, 201)

{
  "success": true,
  "data": {
    "order_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "order_number": "KH-XXXXXXXXXX",
    "amount_xaf": 16000,
    "currency": "XAF",
    "status": "payment_required",
    "payment_required": true
  }
}

Erreurs courantes

`error.code`	Cas
`checkout_disabled`	Checkout automatique désactivé côté serveur
`unavailable` / `pricing_unavailable` / …	Même sémantique que `GET /v1/domains/quote`
`validation_error`	Registrant incomplet

Permissions : domains:write

`POST /v1/domain-orders/{order_uuid}/pay` : payer

POST /v1/domain-orders/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/pay
Authorization: Bearer kh_live_xxxx
Content-Type: application/json
Accept: application/json

{
  "callback_url": "https://votre-app.example/retour-paiement"
}

Champ	Requis	Description
`callback_url`	Non	URL de retour après paiement (défaut : page commande espace client)

Réponse (succès, 200)

{
  "success": true,
  "data": {
    "checkout_url": "https://…/checkout/…",
    "reference": "KHKP-XXXXXXXX-YYYYYYYY",
    "order_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "amount_xaf": 16000,
    "currency": "XAF"
  }
}

Permissions : domains:pay

Exemple PHP (résumé)

$quote = $client->get('domains/quote', ['query' => ['domain' => 'monsite.com', 'years' => 1]]);
$order = $client->post('domains', [
    'domain' => 'monsite.com',
    'years' => 1,
    'registrant' => [ /* … */ ],
]);
$pay = $client->post("domain-orders/{$order['data']['order_uuid']}/pay", [
    'callback_url' => 'https://mon-app.test/ok',
]);
// Rediriger l’utilisateur vers $pay['data']['checkout_url']

Enregistrer un domaine (achat seul)

curl --request POST \
  --url https://kennhosting.com/api/v1/domains \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://kennhosting.com/api/v1/domains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://kennhosting.com/api/v1/domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://kennhosting.com/api/v1/domains"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://kennhosting.com/api/v1/domains")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Introduction

Services

Domaines

Factures

API Revendeurs (White-Label)

Support

Parrainage

Webhooks

Enregistrer un domaine (achat seul)

Flux (API et espace client)

Distinction avec l’hébergement

`POST /v1/domains` : créer la commande

Corps JSON

Objet `registrant`

Réponse (succès, 201)

Erreurs courantes

`POST /v1/domain-orders/{order_uuid}/pay` : payer

Réponse (succès, 200)

Exemple PHP (résumé)

​Flux (API et espace client)

​Distinction avec l’hébergement

​POST /v1/domains : créer la commande

​Corps JSON

​Objet registrant

​Réponse (succès, 201)

​Erreurs courantes

​POST /v1/domain-orders/{order_uuid}/pay : payer

​Réponse (succès, 200)

​Exemple PHP (résumé)

Flux (API et espace client)

Distinction avec l’hébergement

`POST /v1/domains` : créer la commande

Corps JSON

Objet `registrant`

Réponse (succès, 201)

Erreurs courantes

`POST /v1/domain-orders/{order_uuid}/pay` : payer

Réponse (succès, 200)

Exemple PHP (résumé)