Skip to main content
Renouveler un service

Requête

Un renouvellement crée une commande (Order) de type renewal, en statut payment_required, avec un montant basé sur le plan et la période choisie. Le paiement s’effectue ensuite comme pour une facture (ex. POST /v1/invoices/{order_uuid}/pay). Cet endpoint ne prend aucun paramètre de moyen de paiement, celui-ci se choisit à l’étape de paiement.

Paramètres de chemin

Corps de la requête

Réponse (201 Created)

Une seule demande de renouvellement à la fois par service : un second appel pendant qu’une commande de renouvellement est déjà en attente de paiement renvoie 409 avec le code renewal_already_pending (ou renewal_in_progress en cas d’appels quasi simultanés).

Consulter une commande de renouvellement

Une fois l’UUID de commande connu (champ order_id ci-dessus), vous pouvez suivre l’état du renouvellement :
Permission : services:read La réponse inclut notamment uuid, status, montants, dates, et un objet service (domaine, expiration, etc.) si un service est lié à cette commande.

Payer la commande

Utilisez le flux factures :
Permission : invoices:pay Consultez aussi Payer une facture et Statut d’un paiement.

Permissions requises

  • POST …/renew : services:renew
  • GET …/renewals/{order_uuid} : services:read
Les clés sandbox (kh_test_) sont en lecture seule : les POST / PATCH / DELETE retournent 403 avec le code sandbox_read_only. Testez les renouvellements avec une clé live (kh_live_).