← 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

CampoTipoDescripción
dataarrayPayload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
type*stringTipo de recurso JSON:API. Siempre `plan_price`.
id*stringIdentificador compuesto `<currency>_<interval>_<kind>` (ej. `MXN_month_base`).
attributes*objectAtributos públicos de un precio de plan: moneda, intervalo, tipo, importe unitario y tratamiento fiscal.
currency*stringMoneda del precio — `MXN`: Pesos mexicanos; `USD`: Dólares estadounidenses.
billing_interval*stringCadencia de facturación — `month`: Cada mes; `year`: Cada año.
kind*stringTipo de precio — `base`: Cuota fija del ciclo; `metered_overage`: Cargo por unidad consumida por encima de las incluidas en el plan.
unit_amount*integer | nullImporte 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*stringTratamiento del impuesto en `unit_amount` — `inclusive`: Ya incluido; `exclusive`: Se agrega al cobro.
metaobjectMetadatos 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.
versionstringVersión de la API que procesó la petición.
api_versionstringVersión del prefijo de ruta de la API (ej. `v1`).
request_idstringIdentificador único de la petición (hex).
datetimeobjectDescriptor 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*stringSiempre `UTC`: La zona canónica para cada campo datetime del cuerpo.
format*stringSiempre `ISO 8601`: Sufijo `Z` explícito en cada datetime.
linksobjectEnlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

Usado en operaciones

  • GET /v1/plans/{slug}/prices