---
title: "Obtener un producto"
method: GET
path: "/products/{id}"
tags: ["products"]
---

# Obtener un producto

`GET /products/{id}`

Obtén los detalles de un producto específico.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Detalles del producto

- Product
  - `id` string — ID único del producto
  - `status` string — Estado del producto
  - `name` string — Nombre del producto
  - `description` string, nullable — Descripción del producto
  - `success_url` string, nullable — URL de redirección después de un pago exitoso
  - `cancel_url` string, nullable — URL de redirección cuando el comprador cancela
  - `custom_terms_and_conditions` string, nullable — Términos y condiciones personalizados
  - `phone_requirement` 'none' | 'optional' | 'required' — Requerimiento de teléfono
  - `address_requirement` 'none' | 'optional' | 'required' — Requerimiento de dirección
  - `billing_info_requirement` 'none' | 'optional' | 'required' — Requerimiento de información fiscal
  - `has_dynamic_pricing` boolean — Si usa precio dinámico
  - `payment_method_types` ProductPaymentMethodTypesItems[] — Métodos de pago habilitados para este producto, ya resueltos (cuando el producto hereda la configuración de la cuenta, refleja los métodos de la cuenta): `card` (tarjeta, pago de contado), `bank_transfer` (transferencia bancaria), `stablecoins` (dólares digitales), `balance` (Balance Recurrente). Las cuotas se exponen por separado en `available_installments`.
  - `available_installments` integer[] — Opciones de cuotas (en meses) que se mostrarán en el checkout, independientes de `payment_method_types`. Vacío si no se ofrecen cuotas. Solo aplica a GTQ.
  - `prices` Price[] — Precios del producto
    - `id` string — ID único del precio
    - `status` 'active' | 'archived' — Estado del precio. Un precio `archived` fue reemplazado y ya no acepta nuevas compras; las suscripciones existentes lo conservan.
    - `amount_in_cents` integer — Monto en centavos
    - `currency` 'GTQ' | 'USD' — Moneda
    - `charge_type` 'one_time' | 'recurring' — Tipo de cargo
    - `billing_interval` string, nullable — Intervalo de facturación (para suscripciones)
    - `billing_interval_count` integer, nullable — Cada cuántos intervalos se cobra
    - `periods_before_automatic_cancellation` integer, nullable — Períodos antes de cancelar automáticamente
    - `free_trial_interval` string, nullable — Intervalo del período de prueba
    - `free_trial_interval_count` integer, nullable — Duración del período de prueba
    - `proration_behavior` 'none' | 'create_prorations' — Comportamiento de prorrateo del primer cobro de la suscripción. `create_prorations` cobra solo los días restantes hasta el día de cobro; `none` cobra el monto completo.
    - `billing_cycle_anchor_day` integer, nullable — Día del mes (1–31) en que ocurrirán los cobros recurrentes. Si el mes tiene menos días, se cobra el último día.
    - `defer_to_billing_day` boolean — Si es `true`, la suscripción difiere su primer cobro hasta la próxima ocurrencia de `billing_cycle_anchor_day` (solo se guarda el método de pago al crear).
  - `storefront_link` string — Link público del producto en la tienda
  - `metadata` object, nullable — Metadata personalizada
  - `custom_fields` CheckoutCustomFieldDefinition[] — Definiciones de campos personalizados activos en el checkout.
    - `id` string
    - `key` string — Identificador estable usado en webhooks y la API.
    - `type` 'text' | 'numeric' | 'dropdown'
    - `label` object — Hash con la etiqueta en cada idioma soportado. `_original` es lo que escribió el comerciante; el resto se genera automáticamente.
    - `optional` boolean
    - `minimum_length` integer, nullable
    - `maximum_length` integer, nullable
    - `default_value` string, nullable
    - `options` CheckoutCustomFieldDefinitionOptionsItems[], nullable — Solo para `type: dropdown`.
      - `label` string
      - `value` string

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)