Rinnovare un dominio

Crea l'ordine di rinnovo e restituisce come pagarlo.

• Metodo: POST
• Indirizzo: https://console.icbs.it/api/v1/domains/renew
• Permesso: nessuno in particolare, ma non è consentito alle chiavi di un utente in sola lettura

Il rinnovo avviene dopo il pagamento

Questa chiamata non rinnova il dominio: crea un ordine in attesa di pagamento. Il rinnovo parte solo quando il pagamento è confermato.

• con carta, appena il pagamento va a buon fine;
• con bonifico, quando l'incasso viene registrato.

Finché l'ordine non è pagato, la scadenza del dominio non cambia.

Parametri

Esempio di richiesta

curl -X POST -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains":["esempio.it"],"period":1,"paymentMethod":"stripe"}' \
  "https://console.icbs.it/api/v1/domains/renew"

Esempio di risposta con carta

{
  "orderId": 4812,
  "status": "pending_payment",
  "amount": 19.9,
  "currency": "EUR",
  "paymentMethod": "stripe",
  "period": 1,
  "lines": [{ "name": "esempio.it", "period": 1, "unitPrice": 19.9, "price": 19.9 }],
  "coupon": null,
  "checkoutUrl": "https://checkout.stripe.com/c/pay/..."
}

checkoutUrl è la pagina di pagamento: aprila nel browser o inviala a chi deve pagare. Vale per un tempo limitato.

Esempio di risposta con bonifico

{
  "orderId": 4813,
  "status": "pending_payment",
  "amount": 19.9,
  "currency": "EUR",
  "paymentMethod": "bank_transfer",
  "period": 1,
  "lines": [{ "name": "esempio.it", "period": 1, "unitPrice": 19.9, "price": 19.9 }],
  "coupon": null,
  "bank": {
    "iban": "IT00A0000000000000000000000",
    "beneficiary": "...",
    "bankName": "...",
    "reference": "ORD-4813"
  }
}

Indica sempre la causale reference nel bonifico: è ciò che collega il pagamento all'ordine.

Sapere quando è fatto

L'ordine si segue con Stato di un ordine: quando arriva a completed il rinnovo è stato eseguito.

Prima di ordinare

Con Preventivo di rinnovo vedi l'importo esatto, coupon compreso, senza creare nulla.

Possibili errori