Adicionar produtos em um ciclo
Adiciona um ou mais produtos apenas em um ciclo da assinatura. A composição permanente não muda: o ciclo seguinte volta a cobrar os produtos de sempre, sem nenhuma ação adicional.
cycle_index é opcional — sem ele, os produtos entram no próximo
ciclo (completed_cycles + 1). Informando, precisa ser um ciclo ainda
não processado. O ciclo usado vem em cycle_index na resposta.
A forma de identificar o produto é a mesma de
adicionar produtos:
product_id para produtos internos da Appmax, shopify_product_id +
shopify_variant_id para produtos da Shopify. O valor do ciclo passa a
ser o valor da assinatura somado aos produtos adicionados.
Este endpoint também desfaz uma remoção: se o produto informado é da assinatura e tinha sido removido daquele ciclo, ele volta à composição.
Produto avulso, sem exigência de periodicidade
Como o produto vale só para aquele ciclo, a variante não precisa ter a mesma periodicidade da assinatura.
Ciclos pulados
Um ciclo marcado para ser pulado não aceita alterações, e um ciclo alterado não pode ser pulado — desfaça as alterações antes.
Autorizações
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Parâmetros
Parâmetros de Caminho
Identificador da assinatura.
10Corpo da Requisição
Respostas
Produtos adicionados ao ciclo.