Saltar al contenido

Se extiende con el precio actual de tu plan y con las opciones adicionales del pedido. Si el proveedor falla, el cargo se reembolsa automáticamente.

Solo se renuevan los servicios con renewable: true: un servicio que venció por completo o que un administrador suspendió devuelve 409. Si no se puede determinar el precio, no se cobra nada y devuelve 503.

Residential y Mobile son de pago por uso, así que no se renuevan; en estos tipos la solicitud devuelve 400 invalid_request.

Autorización

Authorizationstringobligatorio

Se envía como Bearer <token>. Este endpoint requiere el permiso orders:write (Creación de pedidos); un token sin él recibe 403.

Encabezados

Idempotency-Keystringheaderobligatorio

Un valor único para cada intento de renovación. Ante un tiempo de espera agotado, reintenta con el MISMO valor; no se cobra dos veces y se devuelve la renovación ya completada. Tras un fallo definitivo (4xx o 502 con details.refunded: true), la clave se libera y el mismo valor inicia un intento nuevo.

Parámetros de ruta

idstringobligatorio

El identificador del servicio. Obtenlo del campo id de la respuesta de GET /orders.

Cuerpo

monthsintegerobligatorio

Cuántos meses se extiende (1-12).

auto_renewboolean

Activa o desactiva la renovación automática al mismo tiempo que la renovación.

Respuesta

200
application/json
dataobject
metaobject