Skip to main content
curl -X POST "https://api.chargefy.io/v1/subscription-items" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "price": "price_123",
    "subscription": "sub_123"
  }'

{
  "id": "si_123",
  "object": "subscription_item",
  "aggregate_usage": "sum",
  "amount_discount": 0,
  "amount_subtotal": 20000,
  "amount_tax": 0,
  "amount_total": 20000,
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "discount": null,
  "metadata": {},
  "position": 1,
  "price": "price_pro",
  "price_data": null,
  "product": "prod_123",
  "quantity": 2,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "subscription": "sub_123",
  "unit_amount": 10000,
  "updated_at": null,
  "usage_period_end": null,
  "usage_period_start": null,
  "usage_type": "licensed"
}
Adiciona um item a uma subscription existente sem substituir os itens atuais. Alterações que afetam o valor recorrente geram proration por padrão.
​
subscription
string
required
Subscription que receberá o item (sub_*).
​
price
string
Price recorrente de catálogo. Envie price ou price_data.
​
price_data
object
Preço inline recorrente. Deve incluir product, currency, unit_amount e recurring.interval.
​
quantity
number
Quantidade. Padrão: 1.
​
discount
string
Desconto (disc_*) aplicado ao item.
​
usage_type
string
licensed ou metered. Padrão: licensed.
​
aggregate_usage
string
Para item metered, define como os registros de uso são agregados: sum, last_during_period, last_ever ou max.
​
metadata
object
Metadata do item.
​
proration_behavior
string
create_prorations, always_invoice ou none. Padrão: create_prorations.
​
payment_behavior
string
Controla updates que criam cobrança imediata. Aceita allow_incomplete, default_incomplete, pending_if_incomplete ou error_if_incomplete. Padrão: allow_incomplete. Use error_if_incomplete apenas quando a alteração não gerar valor a cobrar imediatamente.
​
proration_date
string
Timestamp ISO 8601 usado para calcular a proration.
curl -X POST "https://api.chargefy.io/v1/subscription-items" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "price": "price_123",
    "subscription": "sub_123"
  }'

{
  "id": "si_123",
  "object": "subscription_item",
  "aggregate_usage": "sum",
  "amount_discount": 0,
  "amount_subtotal": 20000,
  "amount_tax": 0,
  "amount_total": 20000,
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "discount": null,
  "metadata": {},
  "position": 1,
  "price": "price_pro",
  "price_data": null,
  "product": "prod_123",
  "quantity": 2,
  "recurring": {
    "interval": "month",
    "interval_count": 1
  },
  "subscription": "sub_123",
  "unit_amount": 10000,
  "updated_at": null,
  "usage_period_end": null,
  "usage_period_start": null,
  "usage_type": "licensed"
}