---
title: "Actualizar un cupón"
method: PUT
path: "/coupons/{id}"
tags: ["coupons"]
---

# Actualizar un cupón

`PUT /coupons/{id}`

Actualiza un cupón existente.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Request body

- object
  - `coupon` CouponsIdPutRequestBodyContentApplicationJsonSchemaCoupon, required
    - `name` string — Nombre o código del cupón
    - `amount_off_in_cents` integer — Descuento fijo en centavos
    - `currency` 'GTQ' | 'USD'
    - `percent_off` number, double — Porcentaje de descuento
    - `duration` 'once' | 'forever'
    - `max_redemptions` integer
    - `automatically_applies` boolean — Si es `true`, el descuento se aplica automáticamente en checkouts de tienda
    - `expires_at` string, date-time

## Response `200`

Cupón actualizado

- Coupon
  - `id` string — ID único del cupón
  - `name` string — Nombre o código del cupón
  - `discount_mode` 'code' | 'bank' | 'custom_bins' — Tipo de descuento
  - `display_name` string, nullable — Nombre visible para el cliente (usado en modo custom_bins)
  - `amount_off_in_cents` integer, nullable — Descuento fijo en centavos
  - `percent_off` number, double, nullable — Porcentaje de descuento
  - `automatically_applies` boolean — Si el descuento se aplica automáticamente en checkouts de tienda
  - `max_redemptions` integer, nullable — Número máximo de usos
  - `times_redeemed` integer — Número de veces que se ha redimido el descuento
  - `currency` string, nullable — Moneda del descuento fijo
  - `duration` 'once' | 'forever' — Duración del descuento para suscripciones
  - `expires_at` string, date-time, nullable — Fecha de expiración
  - `status` string — Estado del cupón

## Other responses

- `400` — Error de validación

---

[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)