Alterar a quantidade de um produto
PATCH
/v1/subscriptions/{id}/products/{variantId}/quantity
Altera a quantidade de um produto já presente na assinatura. Vale para os
dois tipos de assinatura — o produto é identificado na URL pelo variantId,
que é o product_id (produtos internos da Appmax) ou o variant_id
(produtos da Shopify) mostrado no detalhe da assinatura. Retorna o detalhe
atualizado.
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.
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
10variantId*
Identificador do produto dentro da assinatura, retornado no detalhe:
- assinaturas de produtos Shopify →
variant_id(oshopify_variant_id); - assinaturas de produtos internos da Appmax →
product_id.
Tipo
Obrigatóriostring
Exemplo
"456"Corpo da Requisição
application/json
JSON "quantity": 3
{
}
Respostas
Quantidade atualizada. Retorna o detalhe atualizado.
application/json
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", "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" }
{
}
PATCH
/v1/subscriptions/{id}/products/{variantId}/quantity