Introducción
Para comerciantes con productos de suscripción, representar correctamente las comisiones recurrentes es clave para la transparencia, los pagos y la confianza de los socios. Affilentra Pro combina software de afiliados self‑hosted con programas de comerciantes y ofrece roles, seguimiento así como funciones de comisión y facturación. Esta guía muestra de forma práctica cómo rastrear eventos de suscripción en Affilentra, configurar reglas de comisiones recurrentes, tratar correctamente el prorrateo en cambios de tarifa y calcular bonos por churn o retención.
1. Crear la base: roles, producto e IDs de tracking
Antes de crear reglas, verifique estos puntos básicos:
- Crear roles: operario del software (Admin), comerciante (Merchant) y socio (Affiliate). Asegúrese de que los comerciantes tengan acceso a la configuración de su programa.
- Registrar el producto como suscripción: En Affilentra, asigne a cada producto de suscripción una ID única de producto/suscripción. Esta ID debe aparecer en los eventos de seguimiento para que los pagos recurrentes se asignen al producto/socio correcto.
- Subscription‑ID en la pila de pagos: Asegúrese de que su proveedor de pagos incluya en cada evento de cargo la Subscription‑ID, la Invoice‑ID y la Transaction‑ID.
2. Rastrear eventos recurrentes: ¿qué eventos necesita?
Como mínimo, los siguientes eventos deberían procesarse en Affilentra:
- initial_sale (primer pago/conversión de prueba)
- subscription_payment (pago recurrente mensual/anual)
- subscription_proration (cambio de tarifa/crédito parcial)
- subscription_cancelled / subscription_expired
- payment_failed / chargeback / refund
En la práctica lo implementa así: su proveedor de pagos envía webhooks al endpoint de tracking de la plataforma. Preste atención a estos campos en el payload: subscription_id, transaction_id, amount, currency, event_type, timestamp, invoice_id, customer_id y, en caso de cambio de tarifa, además previous_plan / new_plan así como prorated_amount o proration_days.
3. Configurar reglas de comisiones recurrentes
Organice las comisiones en tres niveles: pago inicial, pagos posteriores y bonos especiales.
- Pago inicial: Defina una regla para initial_sale (p. ej. 30 % o una cantidad fija). El pago se efectúa tras la validación de la conversión.
- Comisiones mensuales/anuales: Establezca una regla recurrente que se active en cada subscription_payment. La regla puede ser porcentual (p. ej. 10 % por cargo) o una cantidad fija (p. ej. 5 €/mes).
- Controlar dependencias: Permita tasas diferentes para conversiones Trial→Paid, upgrades o downgrades. Use metadatos de producto y tarifa para asignar reglas de forma granular.
Notas técnicas: Utilice la ID de suscripción como clave primaria para la asignación de socios. En la primera venta, almacene la asignación del socio (p. ej. mediante enlace de seguimiento o cupón) en los metadatos de la suscripción, para que los pagos posteriores se asignen automáticamente al socio correcto.
4. Tratar correctamente el prorrateo en cambios de tarifa
Los cambios de tarifa a menudo generan importes parciales. Hay dos enfoques prácticos para calcular la comisión:
- Basado en el importe (recomendado): La comisión se calcula a partir del importe realmente facturado. Si el proveedor de pagos entrega un prorated_amount, la comisión = prorated_amount × commission_rate.
- Basado en el tiempo: Si desea calcular comisiones estrictamente según el tiempo de uso, necesita proration_days o period_lengths. Ejemplo: Comisión prorrateada = (days_active / total_days) × period_commission.
Para representar el prorrateo de forma segura, proceda así:
- El webhook de pago para cambios de tarifa debe contener prorated_amount y datos sobre previous_plan/new_plan.
- En Affilentra cree una regla de procesamiento que se active cuando event_type = subscription_proration y que calcule la comisión basada en prorated_amount.
- Configure idempotencia: compruebe transaction_id e invoice_id para evitar facturaciones duplicadas.
Ejemplo de cálculo: tasa de comisión 10 %, prorated_amount = 15,00 € → Comisión = 1,50 €. Documente en el historial de transacciones la base (prorated_amount, previous_period, new_period) para trazabilidad.
5. Gestión del churn: reclamaciones & bonos de retención
Una gestión limpia del churn abarca dos aspectos: clawbacks (reclamaciones) por cancelación/reembolso y incentivos positivos para la retención.
Clawbacks y ajustes
- En caso de refund, chargeback o subscription_cancelled, Affilentra debe generar un asiento de corrección: comisión negativa o marcación de anulación.
- Política: Decida si con el refund se anula solo la última comisión o de forma proporcional para varios periodos. Implemente la regla como lógica de ajuste automatizada que reaccione a eventos de refund.
Bonos de retención
- Los bonos de retención se pagan cuando un socio contribuye activamente a la fidelización del cliente (p. ej. reactivación tras intención de cancelación, upsell, intervención de soporte exitosa).
- Implementación técnica: Defina un evento disparador retention_success (manual o automatizado por su CRM/soporte) que inicie un pago de bonus. El bono puede ser una cantidad fija o un porcentaje del siguiente cobro.
- Tramos: Pague bonos escalonados, p. ej. bono pequeño por permanencia >30 días, bono mayor por >90 días.
6. Conciliación, informes y pagos
Establezca procesos regulares de conciliación:
- Exporte listas de transacciones con Subscription‑ID, partner, tipo de evento, importe, comisión y estado (paid/adjusted/pending).
- Verifique elementos abiertos: los pagos fallidos y las reclamaciones pendientes deben corregirse antes del pago.
- Utilice la función de facturación de Affilentra para la creación de partidas de pago. Establezca ciclos de pago (mensual, semanal) y defina límites mínimos de pago.
7. Pruebas y buenas prácticas
- Entorno de pruebas: simule todos los eventos de webhook relevantes (initial_sale, subscription_payment, proration, refund, cancel) y compruebe los resultados en el historial del socio.
- Idempotencia: verifique las transaction‑IDs antes de contabilizar para evitar duplicados.
- Documentación: almacene metadatos (p. ej. original_invoice_id, coupon, material promocional) para revisiones posteriores.
- Transparencia: proporcione a los socios un historial de pagos trazable (tracking links, periodos, deducciones por reembolsos).
- Protección de datos y cumplimiento: cuide el almacenamiento de datos de clientes según el RGPD y, si es posible, seudonimice.
Conclusión y pasos de implementación
Affilentra Pro proporciona la infraestructura necesaria para modelar internamente suscripciones, prorrateo y lógica de churn. Resumidos, los siguientes pasos:
- Crear IDs de producto/suscripción en Affilentra y guardar la asignación del socio en la primera compra.
- Implementar la integración de webhook con el proveedor de pago y enviar todos los campos relevantes (especialmente subscription_id, transaction_id, prorated_amount).
- Configurar las reglas de comisión para el primer pago y los pagos recurrentes; procesar los eventos de prorrateo de modo que las comisiones se basen en prorated_amount.
- Introducir y automatizar los ajustes por churn y los bonos de retención como eventos desencadenados.
- Realizar pruebas exhaustivas y establecer reporting/coordinación para los pagos.
Si está listo para operar su programa de afiliados para suscripciones de forma segura y transparente, elija su punto de entrada: Einstieg wählen.
Siguiente paso
Probar Affilentra usted mismo
Plataforma unificada que integra de forma transparente la provisión de productos, el seguimiento, la validación de conversiones, el cálculo de comisiones y los pagos mediante roles claramente separados; opción de instalación self‑hosted con licencia perpetua sin participación en los ingresos; los comerciantes conservan el control sobre productos, condiciones y materiales promocionales; los socios reciben enlaces de seguimiento personales y un historial de pagos verificable.