API · Crear cupón

API v1

POST /api/v1/createCoupon

Qué 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#

Requiere el token bearer del API en el header Authorization — ver autenticación.

Parámetros#

keystringrequerido#

Key de la integración Tilopay.

planIdintegerrequerido#

Id del plan recurrente.

active_usersintegerrequerido#

Permiso de usuarios.

Código	Valor
0	Permitir solo usuarios nuevos
1	Permitir usuarios ya registrados

type_discountintegerrequerido#

Tipo de descuento.

Código	Valor
1	Porcentaje
2	Monto fijo

discountintegerrequerido#

Valor numérico del descuento.

expirestringrequerido#

Fecha de expiración del cupón, formato Y-m-d (por ejemplo 2025-10-20).

email_groupintegerrequerido#

Permiso de correos.

Código	Valor
1	Correos específicos
2	Cualquier correo

emailstring#

Lista de correos separados por coma. Requerido si email_group se envía en 1.

usageinteger#

Cantidad total de usos.

renewsinteger#

Cantidad total de renovaciones válidas.

renews_by_userinteger#

Total de usos por un mismo usuario.

Ejemplo de request#

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

{
  "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.

Última verificación: 2026-08-29 · Responsable: equipo-integraciones

Ver como Markdown crudo