Pular para o conteúdo

A renovação usa o preço atual do seu plano e as opções adicionais do pedido. Se o provedor falhar, o valor é reembolsado automaticamente.

Só são renovados serviços com renewable: true: um serviço totalmente vencido ou suspenso por um administrador retorna 409. Se o preço não puder ser determinado, nada é cobrado e retorna 503.

Residential e Mobile não são renovados, pois são pagos conforme o uso; nesses tipos, a requisição retorna 400 invalid_request.

Autorização

Authorizationstringobrigatório

Enviado no formato Bearer <token>. Este endpoint exige o escopo orders:write (Criação de pedidos); um token sem esse escopo recebe 403.

Cabeçalhos

Idempotency-Keystringheaderobrigatório

Um valor único para cada tentativa de renovação. Em caso de timeout, tente de novo com o MESMO valor; a cobrança não é feita duas vezes e a renovação concluída é retornada. Após uma falha definitiva (4xx ou 502 com details.refunded: true), a chave é liberada e o mesmo valor inicia uma nova tentativa.

Parâmetros de caminho

idstringobrigatório

ID do serviço. Obtenha-o no campo id da resposta de GET /orders.

Corpo

monthsintegerobrigatório

Quantos meses renovar (1-12).

auto_renewboolean

Ativa ou desativa a renovação automática junto com a renovação.

Resposta

200
application/json
dataobject
metaobject