Actualizar un producto | Documentación API de Recurrente

{
  "id": "prod_9lstwgbr",
  "status": "active",
  "name": "El nombre de tu producto",
  "description": "string",
  "success_url": "string",
  "cancel_url": "string",
  "custom_terms_and_conditions": "string",
  "phone_requirement": "optional",
  "address_requirement": "none",
  "billing_info_requirement": "optional",
  "has_dynamic_pricing": false,
  "payment_method_types": [
    "card",
    "bank_transfer"
  ],
  "available_installments": [
    3,
    6
  ],
  "prices": [
    {
      "id": "price_rky4dog7",
      "status": "active",
      "amount_in_cents": 500,
      "currency": "GTQ",
      "charge_type": "one_time",
      "billing_interval": "month",
      "billing_interval_count": 1,
      "periods_before_automatic_cancellation": 1,
      "free_trial_interval": "string",
      "free_trial_interval_count": 1,
      "proration_behavior": "none",
      "billing_cycle_anchor_day": 1,
      "defer_to_billing_day": true
    }
  ],
  "storefront_link": "https://app.recurrente.com/s/surf-office/el-nombre-de-tu-producto",
  "metadata": {},
  "custom_fields": [
    {
      "id": "ccf_xxxxxxxxxxxx",
      "key": "engraving",
      "type": "text",
      "label": {
        "_original": "Mensaje de grabado",
        "en": "Engraving message",
        "es": "Mensaje de grabado"
      },
      "optional": false,
      "minimum_length": 1,
      "maximum_length": 1,
      "default_value": "string",
      "options": [
        {
          "label": "string",
          "value": "string"
        }
      ]
    }
  ]
}

Actualiza un producto existente. Para actualizar el precio, incluye el id del precio dentro de prices_attributes.

Si el precio tiene suscripciones (activas, pausadas o con pago pendiente), no se modifica en su lugar: se archiva y se crea un precio de reemplazo con un id nuevo, que viene en la respuesta — guárdalo si almacenas IDs de precios. Las suscripciones existentes conservan el precio archivado (mismo monto y plan). Crear un checkout con el id de un precio archivado usa automáticamente su reemplazo vigente. Enviar una actualización con el id de un precio archivado responde 400 indicando el precio vigente.

Actualiza un producto existente. Para actualizar el precio, incluye el `id` del precio dentro de `prices_attributes`. Si el precio tiene suscripciones (activas, pausadas o con pago pendiente), no se modifica en su lugar: se archiva y se crea un precio de reemplazo con un `id` nuevo, que viene en la respuesta — guárdalo si almacenas IDs de precios. Las suscripciones existentes conservan el precio archivado (mismo monto y plan). Crear un checkout con el `id` de un precio archivado usa automáticamente su reemplazo vigente. Enviar una actualización con el `id` de un precio archivado responde `400` indicando el precio vigente.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API

Path parameters

idstringRequired

ID del producto

Request

This endpoint expects an object.

productobjectRequired

Response

Producto actualizado

idstring

ID único del producto

statusstring

Estado del producto

namestring

Nombre del producto

descriptionstring or null

Descripción del producto

success_urlstring or null

URL de redirección después de un pago exitoso

cancel_urlstring or null

URL de redirección cuando el comprador cancela

custom_terms_and_conditionsstring or null

Términos y condiciones personalizados

phone_requirementenumDefaults to optional

Requerimiento de teléfono

address_requirementenumDefaults to none

Requerimiento de dirección

billing_info_requirementenumDefaults to optional

Requerimiento de información fiscal

has_dynamic_pricingboolean

Si usa precio dinámico

payment_method_typeslist of enums

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_installmentslist of integers

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.

priceslist of objects

Precios del producto

storefront_linkstring

Link público del producto en la tienda

metadatamap from strings to strings or null

Metadata personalizada

custom_fieldslist of objects

Definiciones de campos personalizados activos en el checkout.

Errors

400

Bad Request Error

$	curl -X PUT https://app.recurrente.com/api/products/id \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"product": {}
>	}'