Códigos de descuento para comunidades de pago
Códigos porcentuales o de importe fijo con límites de uso, límites de gasto, restricciones por miembro y por plan, y un calendario. Los miembros escriben el código al pagar.
Un código de descuento permite a un miembro pagar menos al finalizar la compra escribiendo un código como LAUNCH20. En Arcalotl controlas el valor del código, cuánto tiempo se aplica, quién puede usarlo, en qué planes funciona y entre qué fechas es válido.
Los códigos funcionan en planes recurrentes y en compras únicas. Las donaciones no aceptan códigos de descuento.
Los descuentos no cambian cómo te cobra Arcalotl. La comisión es del 2 % de cada pago completado, así que un pago con descuento lleva una comisión menor, y en ningún caso hay coste mensual.
Porcentaje o importe fijo
Un código descuenta o bien un porcentaje del 1 al 100 o bien un importe fijo en una moneda. Un código de importe fijo solo se aplica a planes con precio en esa misma moneda, así que un código de 5,00 EUR no se aplica en silencio a un plan con precio en dólares.
Duración en planes recurrentes
En una suscripción eliges cuánto dura el descuento: solo el primer pago, un número determinado de meses o para siempre. Un código de primer pago descuenta la primera factura, un código repetido descuenta los meses que configures y un código para siempre se aplica a cada renovación. Las compras únicas siempre aplican el descuento una vez.
Límites de uso que no se pueden sobrevender
Un límite de uso acota el total de canjes entre todos los miembros, y dejarlo vacío significa usos ilimitados. Un pago en curso reserva una plaza hasta que se completa o caduca, así que un código limitado a 50 usos nunca puede canjearse 51 veces mediante pagos en paralelo.
Gasto mínimo y máximo
Los límites de gasto deciden qué precios toca un código, en la moneda del plan. Un mínimo de 10,00 hace que el código funcione solo en compras de 10,00 o más. Un máximo mantiene el código en tus artículos más baratos. Ambos son opcionales.
Restringido a miembros concretos
Un código puede limitarse a miembros que elijas de la lista de miembros de tu servidor, lo que lo convierte en una oferta privada para esas personas. Sin miembros seleccionados, cualquiera que tenga el código puede usarlo.
Restringido a planes concretos
Un código puede limitarse a los planes que elijas. Sin nada seleccionado funciona en todos los planes de tu catálogo, así que un código de lanzamiento general y un código de mejora para un solo plan son la misma función con una restricción distinta.
Inicio y caducidad programados
Una fecha de inicio decide cuándo se activa un código y una fecha de caducidad decide cuándo deja de funcionar. Sin definir significa activo de inmediato y sin caducidad. Así es como un código de temporada se activa y termina sin que nadie tenga que estar despierto.
Claro al pagar
La página de pago muestra un enlace de código de descuento siempre que tu comunidad tenga al menos un código activo. Un código válido actualiza el total en el acto y muestra la línea de reducción. Un código rechazado explica por qué, por ejemplo que ha caducado, que aún no ha empezado o que está por debajo del gasto mínimo, sin revelar nada sobre tus otros códigos.
Las ediciones se aplican a pagos futuros
Cambiar un código nunca afecta a un pago que ya esté abierto, que conserva el descuento con el que se abrió. Archivar un código detiene los canjes nuevos de inmediato y conserva su historial de canjes, y los pagos que ya estaban en curso se completan igualmente. Un código no se puede renombrar una vez creado.
Uso que puedes consultar
La tabla de Descuentos muestra los canjes de cada código frente a su límite de uso, sus restricciones y su estado actual: activo, programado, caducado, agotado o desactivado. Las compras únicas registran el importe con descuento que el comprador pagó realmente, así que las analíticas de ingresos siguen siendo exactas.
Panel, API y MCP
Los códigos se crean y editan en la página Descuentos del panel. La API pública expone GET /v1/discounts con restricciones, calendario y recuento de canjes bajo el permiso discounts:read, y POST /v1/checkout-links acepta un discount_code para asociar un código a un enlace que generes. El servidor MCP expone el mismo listado como la herramienta list_discounts, así que un asistente puede informar sobre los códigos sin poder cambiarlos.
Qué configuras en un código
| Ajuste | Qué hace | Si se deja vacío |
|---|---|---|
| Código | Hasta 64 letras, números, guiones bajos o guiones. No distingue mayúsculas y es único por comunidad | Obligatorio |
| Valor | Un porcentaje del 1 al 100, o un importe fijo en una moneda | Obligatorio |
| Duración | Solo el primer pago, repetido durante un número de meses, o para siempre | Obligatorio en planes recurrentes |
| Límite de uso | Total de canjes entre todos los miembros | Usos ilimitados |
| Gasto mínimo | El precio de plan más bajo al que se aplica el código | Sin límite inferior |
| Gasto máximo | El precio de plan más alto al que se aplica el código | Sin límite superior |
| Miembros | Limita el código a miembros elegidos de tu lista de miembros | Todo el mundo puede usarlo |
| Planes | Limita el código a los planes elegidos | Funciona en todos los planes |
| Fecha de inicio | Cuándo se activa el código | Activo de inmediato |
| Fecha de caducidad | Cuándo deja de funcionar el código | Nunca caduca |
Lo que los códigos de descuento no hacen
Las donaciones no aceptan códigos de descuento. Un bloque o comando de donación toma el importe que elige el miembro, y un código introducido ahí no hace nada.
Un código de importe fijo está ligado a su moneda. Solo se aplica a planes con precio en la misma moneda, así que una comunidad que vende en varias monedas necesita un código de importe fijo por moneda, o un código porcentual en su lugar.
Un código no se puede renombrar una vez que existe, porque el propio código es lo que escribieron los miembros y aquello contra lo que se registra tu historial de canjes. Para cambiar el texto de una oferta, crea un código nuevo y archiva el antiguo.
La API y el servidor MCP son de solo lectura para los descuentos. Crear, editar y archivar se hace en el panel.
Preguntas
Sigue leyendo
Lanza tu primer código
Los códigos de descuento forman parte de Arcalotl sin coste adicional. Crea uno en la página Descuentos y compártelo donde estén tus miembros.
Abrir el panel