Pular um ciclo
PATCH
/v1/subscriptions/{id}/cycles/{cycleIndex}/skip
Marca um ciclo futuro para ser pulado: a assinatura segue ativa, mas aquele ciclo não gera cobrança nem pedido — a cobrança salta para o próximo ciclo não pulado.
cycleIndex é o número do ciclo (1 = primeiro ciclo de recorrência).
Só é possível pular ciclos ainda não processados — use
completed_cycles do detalhe da assinatura como referência.
Para desfazer, chame desfazer o skip.
Autorizações
bearerAuth
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Tipo
HTTP (bearer)
Parâmetros
Parâmetros de Caminho
id*
Identificador da assinatura.
Tipo
Obrigatóriointeger
Exemplo
10cycleIndex*
Número do ciclo de recorrência (1 = primeiro ciclo após a cobrança de
origem). Precisa ser maior que completed_cycles.
Tipo
Obrigatóriointeger
Exemplo
3Mínimo
1Respostas
Ciclo marcado como pulado.
application/json
JSON "data": { "cycle_index": 3, "status": "skipped", "next_charge_at": "2026-10-15 00:00:00" }
{
}
PATCH
/v1/subscriptions/{id}/cycles/{cycleIndex}/skip