Adicionar produtos

POST

/v1/subscriptions/{id}/products

Adiciona um ou mais produtos a uma assinatura existente. Retorna o detalhe atualizado da assinatura.

Funciona para os dois tipos de assinatura, e a forma de identificar o produto muda conforme o tipo — sempre use os identificadores devolvidos por produtos disponíveis:

• Produtos internos da Appmax → product_id (+ quantity). Nome, preço e SKU vêm do cadastro do produto; se enviados, são ignorados.
• Produtos da Shopify → shopify_product_id e shopify_variant_id (+ quantity). O preço é lido da variante.

A assinatura precisa estar "parada"

Alterar produtos só é permitido enquanto a assinatura está ativa, não pausada e sem cobrança em andamento. Veja os erros 409 e 422 abaixo.

Assinaturas sem produtos

A gestão de produtos exige uma assinatura com produtos definidos: criada com products no criar assinatura ou originada de um checkout Shopify. Assinaturas criadas sem products (que herdam o valor do pedido) respondem 404 aqui.

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

integer

Obrigatório

Exemplo10

Corpo da Requisição

application/json

{

  

"products": [

  

  

{

  

  

  

"product_id": 55,

  

  

  

"quantity": 1

  

  

}

  

]

}

Respostas

Produtos adicionados. Retorna o detalhe atualizado.

Content-Type

application/json

{

  

"data": {

  

  

"subscription_id": 10,

  

  

"tag": "Clube do Whey",

  

  

"status": "ACTIVE",

  

  

"products": [

  

  

  

{

  

  

  

  

"name": "Camiseta Preta",

  

  

  

  

"shopify_product_id": "string",

  

  

  

  

"variant_id": "string",

  

  

  

  

"product_id": 55,

  

  

  

  

"sku": "SKU-1",

  

  

  

  

"quantity": 1,

  

  

  

  

"price": 199.9,

  

  

  

  

"image_url": "string",

  

  

  

  

"compare_at_price": 0

  

  

  

}

  

  

],

  

  

"value": 199.9,

  

  

"freight_value": 19.9,

  

  

"interval": "month",

  

  

"interval_count": 1,

  

  

"current_cycle": 3,

  

  

"completed_cycles": 2,

  

  

"customer": {

  

  

  

"name": "Maria Silva",

  

  

  

"email": "[email protected]",

  

  

  

"document": "12345678909",

  

  

  

"phone": "11999999999",

  

  

  

"address": {

  

  

  

  

"street": "Rua São Bento",

  

  

  

  

"number": "111",

  

  

  

  

"complement": "Bloco 7",

  

  

  

  

"district": "Centro",

  

  

  

  

"city": "São Paulo",

  

  

  

  

"state": "SP",

  

  

  

  

"postcode": "01010000"

  

  

  

}

  

  

},

  

  

"payment": {

  

  

  

"payment_info": {

  

  

  

  

"brand": "visa",

  

  

  

  

"final": "1234",

  

  

  

  

"expiration": "12/2029"

  

  

  

}

  

  

},

  

  

"max_cycles": 12,

  

  

"skipped_cycles": [

  

  

  

[

  

  

  

  

3

  

  

  

]

  

  

],

  

  

"next_charge_at": "2026-08-15 00:00:00",

  

  

"last_charge_at": "15/07/2026",

  

  

"charges": [

  

  

  

{

  

  

  

  

"cycle": 1,

  

  

  

  

"order_id": 12345,

  

  

  

  

"shopify_order_id": "6868591542526",

  

  

  

  

"charged_at": "15/07/2026",

  

  

  

  

"value": 199.9,

  

  

  

  

"status": "paid"

  

  

  

}

  

  

],

  

  

"created_at": "2026-06-15 10:00:00",

  

  

"canceled_at": "string",

  

  

"paused_from": "string",

  

  

"paused_until": "string",

  

  

"pause_reason": "Cliente vai viajar",

  

  

"cancel_reason": "Achou caro"

  

}

}

POST

/v1/subscriptions/{id}/products

Exemplos

Sandboxhttps://api.sandboxappmax.com.br

Parâmetros da URL

id

Authorization (Bearer)

Cole uma vez e use em todos os playgrounds — o token fica salvo somente nesta aba do navegador e é apagado quando ela for fechada.

Corpo

{
  "products": [
    {
      "product_id": 55,
      "quantity": 1
    }
  ]
}

Duplo clique no JSON para editar