SubscriptionItem representa una sola línea con precio dentro de una suscripción. Cada item enlaza un precio con una cantidad y determina lo que se le cobra al cliente cada período. Una suscripción siempre debe contener al menos un item.
{
"id": "si_89abcdef0123",
"object": "subscription_item",
"price": {
"currency": "CLP",
"product": {
"id": "prod_a7dkfnea",
"object": "product",
"created_at": "2025-08-01T00:00:00Z",
"description": null,
"image_url": null,
"metadata": {},
"mode": "live",
"name": "Pro Plan"
},
"recurring": {
"interval": "month",
"interval_count": 1
},
"unit_amount": 15000
},
"quantity": 2
}
| Atributo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del subscription item. |
object | string | String que representa el tipo del objeto. Siempre "subscription_item". |
price | object | Configuración de precio para este item. |
price.currency | string | Código de moneda ISO 4217 de tres letras. |
price.product | object | Producto asociado a este precio. |
price.product.id | string | Identificador único del producto. |
price.product.object | string | String que representa el tipo del objeto. Siempre "product". |
price.product.created_at | string | Marca de tiempo ISO 8601 de cuándo se creó el producto. |
price.product.description | string | Descripción del producto. null si no está definida. |
price.product.image_url | string | URL de una imagen para el producto. null si no está definida. |
price.product.metadata | object | Conjunto de pares clave-valor adjuntos al producto. |
price.product.mode | string | "live" o "test". |
price.product.name | string | Nombre del producto. |
price.recurring | object | Configuración de recurrencia para este precio. |
price.recurring.interval | string | Intervalo de facturación. Uno de "month" o "year". |
price.recurring.interval_count | integer | Número de intervalos entre facturaciones. |
price.unit_amount | integer | Monto cobrado por unidad en la unidad mínima de la moneda (por ejemplo, 15000 para $15.000 CLP). |
quantity | integer | Número de unidades incluidas en cada período de facturación. |