# API · Crear cupón

> Creación de cupones de descuento para planes recurrentes.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api/recurrentes/cupones/create-coupon

```http
POST /api/v1/createCoupon
```

## Qué hace [#que-hace]

Crea un cupón de descuento para un plan recurrente: tipo de descuento, expiración, permisos de usuario y de correo, y límites de uso.

## Autenticación [#autenticacion]

Requiere el token bearer del API en el header `Authorization` — ver [autenticación](/developers/api/autenticacion).

## Parámetros [#parametros]

<Param id="create-coupon-parametro-key" name="key" type="string" required>
Key de la integración Tilopay.
</Param>

<Param id="create-coupon-parametro-planid" name="planId" type="integer" required>
Id del plan recurrente.
</Param>

<Param id="create-coupon-parametro-active-users" name="active_users" type="integer" required>
Permiso de usuarios.

| Código | Valor |
| --- | --- |
| 0 | Permitir solo usuarios nuevos |
| 1 | Permitir usuarios ya registrados |
</Param>

<Param id="create-coupon-parametro-type-discount" name="type_discount" type="integer" required>
Tipo de descuento.

| Código | Valor |
| --- | --- |
| 1 | Porcentaje |
| 2 | Monto fijo |
</Param>

<Param id="create-coupon-parametro-discount" name="discount" type="integer" required>
Valor numérico del descuento.
</Param>

<Param id="create-coupon-parametro-expire" name="expire" type="string" required>
Fecha de expiración del cupón, formato `Y-m-d` (por ejemplo 2025-10-20).
</Param>

<Param id="create-coupon-parametro-email-group" name="email_group" type="integer" required>
Permiso de correos.

| Código | Valor |
| --- | --- |
| 1 | Correos específicos |
| 2 | Cualquier correo |
</Param>

<Param id="create-coupon-parametro-email" name="email" type="string">
Lista de correos separados por coma. Requerido si `email_group` se envía en 1.
</Param>

<Param id="create-coupon-parametro-usage" name="usage" type="integer">
Cantidad total de usos.
</Param>

<Param id="create-coupon-parametro-renews" name="renews" type="integer">
Cantidad total de renovaciones válidas.
</Param>

<Param id="create-coupon-parametro-renews-by-user" name="renews_by_user" type="integer">
Total de usos por un mismo usuario.
</Param>

## Ejemplo de request [#request]

Los valores `<...>` son marcadores: reemplazalos por tus credenciales y datos.

```json
{
  "key": "<api_key>",
  "planId": 10,
  "active_users": 1,
  "type_discount": 1,
  "discount": 40,
  "expire": "2025-10-20",
  "email_group": 1,
  "email": "cliente@ejemplo.com, cliente@ejemplo.com",
  "usage": 1,
  "renews": 2,
  "renews_by_user": 2
}
```

Para interpretar una respuesta que no es de éxito, ver [cómo leer una respuesta de error](/developers/api/procesos-operativos/errors).