Split para recurrencia

definición el módulo de suscripciones con split extiende la capacidad de cobro recurrente de la plataforma suga para habilitar esquemas donde el importe de cada ejecución se distribuye automáticamente entre múltiples entidades o comercios, en el mismo momento en que el cobro se procesa resuelve un problema estructural en modelos de negocio que involucran múltiples partes marketplaces, agregadores, plataformas con comisiones, modelos de franquicia o cualquier esquema donde el flujo de fondos recurrente no va íntegramente a un solo destinatario sino que se divide según reglas preestablecidas a diferencia de una suscripción estándar —donde el monto total acredita en una única entidad— una suscripción con split define en su configuración cómo se reparte ese monto entre la entidad originante y una o más entidades receptoras, incluyendo la comisión que retiene quien genera la operación c oncepto central del split entidad originante → genera la suscripción y retiene una comisión (fee) por cada ejecución entidades receptoras → reciben la porción del cobro que les corresponde según la configuración del split operación padre → la transacción principal registrada en la entidad originante operaciones hijas → una transacción derivada por cada entidad receptora definida en el split el split en suscripciones abstrae uno de los problemas más complejos en modelos de negocio multi parte coordinar el cobro recurrente y la distribución de fondos entre múltiples entidades sin que cada una de ellas deba gestionar sus propios cobros, sus propias suscripciones o sus propios procesos de autorización la plataforma suga encapsula todo esto en una única instrucción de split configurada una sola vez flujo abstraído por el módulo configuración única del split → aplica en cada ejecución del ciclo de vida de la suscripción un cobro al suscriptor → múltiples acreditaciones automáticas a las entidades del split operación padre + n operaciones hijas → trazabilidad completa por entidad retención opcional (hold) → acreditación condicionada a liberación explícita devolución → reintegro automático proporcional a cada entidad receptora rol dentro de la plataforma el split en suscripciones es una extensión del modelo de distribución de fondos que la plataforma suga implementa de forma transversal la misma lógica de split disponible en checkout y links de pago se aplica aquí al ciclo de cobro recurrente, garantizando consistencia en el tratamiento financiero independientemente del canal de origen dentro de la arquitectura suga, este módulo se posiciona como una capa de configuración financiera sobre el motor de suscripciones existente no reemplaza ningún componente extiende la suscripción estándar con una instrucción de distribución que el smart acquiring core ejecuta en cada ciclo de cobro módulo relacionado relación con split en suscripciones módulo de suscripciones provee la estructura base (suscripción + suscriptor + ejecución) sobre la que opera el split smart acquiring core ejecuta la autorización del cobro y distribuye los fondos entre las entidades del split en cada ejecución gestión de transacciones registra la operación padre y cada operación hija como transacciones trazables e independientes módulo de liquidaciones cada entidad receptora recibe su porción en su propia liquidación; la comisión se acredita a la entidad originante módulo acl / roles y permisos controla qué entidades pueden ser configuradas como receptoras en un split módulo marketplace comparte el mismo modelo conceptual de split; las suscripciones con split son su extensión al cobro recurrente funcionamiento del módulo el split en suscripciones opera en dos niveles independientes a nivel de la suscripción y a nivel del suscriptor esto permite configurar una distribución por defecto en la plantilla y sobrescribirla para suscriptores específicos cuando el modelo de negocio lo requiere split a nivel suscripción cuando se crea una suscripción con el nodo split, se establece la regla de distribución que se aplicará por defecto en cada ejecución de cobro de todos sus suscriptores la configuración incluye • las entidades receptoras (hasta 50 por operación) • el monto total que corresponde a cada entidad receptora • la comisión (fee) que retiene la entidad originante sobre cada porción regla crítica de validación la suma de los montos declarados en el array split debe ser igual al total de la suscripción si los montos no coinciden, la plataforma rechaza la creación con un error de validación esto garantiza que el 100% del importe cobrado quede asignado sin ambigüedad split a nivel suscriptor es posible sobrescribir la configuración de split a nivel individual de cada suscriptor esto permite escenarios donde distintos suscriptores dentro de una misma suscripción tienen reglas de distribución diferentes distintos montos, distintas entidades receptoras o distintas comisiones cuando se edita un suscriptor enviando el nodo split, la nueva configuración reemplaza la del split definido en la suscripción para ese suscriptor en particular el resto de los suscriptores continúan usando la configuración original de la suscripción modelo de operación padre / hija cada ejecución de una suscripción con split genera una estructura de transacciones relacionadas estructura de transacciones por ejecución operación padre → registrada en la entidad originante · contiene el total cobrado y la comisión retenida operación hija 1 → registrada en la entidad receptora 1 · monto según configuración del split operación hija n → una por cada entidad receptora adicional definida en el array split cada operación hija posee su propio uid, lo que permite trazarla de forma independiente, consultarla en el módulo de gestión de transacciones y ejecutar acciones sobre ella (por ejemplo, liberación de fondos en caso de retención) retención de fondos (hold) el parámetro hold permite retener temporalmente los fondos de una operación hija cuando hold es true, los fondos se reservan en lugar de acreditarse inmediatamente a la entidad receptora la liberación debe realizarse de forma explícita vía api mediante el endpoint de liberación de fondos este mecanismo es útil en modelos donde la acreditación al vendedor o receptor está condicionada a una confirmación externa entrega del servicio, validación de cumplimiento, aprobación manual, entre otros devoluciones y comisión el parámetro refundfee controla si la comisión retenida por la entidad originante se devuelve en caso de una devolución total de la operación por defecto su valor es true, lo que significa que ante una devolución la comisión también se reintegra al suscriptor este comportamiento puede configurarse por cada porción del split de forma independiente componentes y funcionalidades principales configuración del split en la suscripción • definición de hasta 50 entidades receptoras por suscripción • asignación de monto total y comisión (fee) por entidad receptora • validación automática de que la suma de montos coincide con el total de la suscripción • soporte para retención de fondos (hold) por porción • control de devolución de comisión (refundfee) por porción • descripción y referencia individual por operación hija configuración del split en el suscriptor • sobrescritura del split a nivel individual de suscriptor • actualización de monto total del suscriptor con nueva distribución • permite distintas reglas de distribución dentro de una misma suscripción trazabilidad de operaciones hijas (chd) • cada porción del split genera una operación hija con uid propio • las operaciones hijas son consultables en el módulo de gestión de transacciones • los uid se incluyen en la respuesta de creación de la suscripción para su almacenamiento liberación de fondos retenidos • endpoint dedicado para liberar fondos retenidos (hold) sobre operaciones hijas • la liberación es individual por operación hija • permite flujos de acreditación condicionada a eventos externos dimensiones y entidades del módulo entidad descripción suscripción con split plantilla de cobro recurrente con instrucción de distribución de fondos configurada en el nodo split entidad originante comercio o entidad que genera la suscripción, retiene la comisión y registra la operación padre entidad receptora comercio o entidad que recibe una porción del cobro recurrente según la configuración del split operación padre transacción principal registrada en la entidad originante en cada ejecución de cobro operación hija transacción derivada registrada en cada entidad receptora, con uid propio y monto según split nodo split array de objetos json que define la distribución entidad, total, fee, hold, reference, refundfee fee monto de comisión que retiene la entidad originante sobre la porción de cada entidad receptora flujo operativo flujo — suscripción con split (tipo dynamic) 1 operador crea suscripción con nodo split → configuración de distribución establecida 2 respuesta incluye uid de operaciones hijas pregeneradas → operador los almacena 3 suscriptor carga medio de pago (sourceurl) → token registrado en security vault 4 webhook subscription registration → suscriptor activo 5 plataforma ejecuta cobro según agenda → smart acquiring core autoriza 6 aprobado se acredita porción a cada entidad del split → operación padre + hijas 7 cada entidad recibe su webhook de ejecución con su operación hija 8 si hold true → fondos retenidos hasta llamada a /release 9 ejecuciones aprobadas se incluyen en liquidación de cada entidad según su porción beneficios y valor operativo dimensión valor que aporta el módulo modelos multi parte nativos habilita marketplaces, agregadores y modelos de franquicia con cobro recurrente sin construir infraestructura adicional distribución automática cada ejecución del ciclo recurrente distribuye fondos sin intervención manual trazabilidad por entidad cada receptor tiene su propia operación hija con uid propio, consulta y auditoría independiente flexibilidad por suscriptor el split puede sobrescribirse a nivel individual para modelos con variaciones entre suscriptores control de acreditación la retención (hold) permite condicionar la acreditación a eventos o validaciones externas consistencia financiera la validación de suma garantiza que el 100% del cobro queda asignado sin huecos ni excedentes integración en liquidaciones cada entidad del split participa de su propio proceso de liquidación dentro de la plataforma suga qué transmite este módulo el módulo de suscripciones con split demuestra que la plataforma suga comprende que los modelos de cobro recurrente modernos raramente son transacciones uno a uno los ecosistemas de pagos actuales involucran múltiples partes, comisiones, retenciones y distribuciones que deben operar de forma automática, consistente y trazable en cada ciclo ✔ cobro recurrente nativo para modelos multi entidad (marketplaces, agregadores, franquicias) ✔ distribución automática de fondos en cada ejecución del ciclo de suscripción ✔ trazabilidad completa operación padre + operaciones hijas con uid propio ✔ flexibilidad de configuración a nivel suscripción y a nivel suscriptor ✔ control de acreditación mediante retención y liberación explícita de fondos ✔ integración nativa con liquidaciones, conciliación y gestión de transacciones