← Volver al índice de esquemas
ListPlanPricesResponse
Respuesta de `GET /v1/plans/{slug}/prices` con los precios activos y un resumen del plan en `meta.plan`.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
data | array | Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`). |
type* | string | Tipo de recurso JSON:API. Siempre `plan_price`. |
id* | string | Identificador compuesto `<currency>_<interval>_<kind>` (ej. `MXN_month_base`). |
attributes* | object | Atributos públicos de un precio de plan: moneda, intervalo, tipo, importe unitario y tratamiento fiscal. |
currency* | string | Moneda del precio — `MXN`: Pesos mexicanos; `USD`: Dólares estadounidenses. |
billing_interval* | string | Cadencia de facturación — `month`: Cada mes; `year`: Cada año. |
kind* | string | Tipo de precio — `base`: Cuota fija del ciclo; `metered_overage`: Cargo por unidad consumida por encima de las incluidas en el plan. |
unit_amount* | integer | null | Importe en la unidad mínima de la moneda. `null` cuando Stripe calcula un precio escalonado al facturar y no puede mostrarse como una sola cifra. |
tax_behavior* | string | Tratamiento del impuesto en `unit_amount` — `inclusive`: Ya incluido; `exclusive`: Se agrega al cobro. |
meta | object | Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC. |
version | string | Versión de la API que procesó la petición. |
api_version | string | Versión del prefijo de ruta de la API (ej. `v1`). |
request_id | string | Identificador único de la petición (hex). |
datetime | object | Descriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec. |
timezone* | string | Siempre `UTC`: La zona canónica para cada campo datetime del cuerpo. |
format* | string | Siempre `ISO 8601`: Sufijo `Z` explícito en cada datetime. |
links | object | Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada. |
Usado en operaciones
GET /v1/plans/{slug}/prices