Modalidades de Procesamiento
La API opera en dos modos que determinan el destino inmediato de los fondos cuando una transacción es procesada exitosamente. El modo activo para cada integrador es configurado por CUCU durante el onboarding comercial.CUCU Pay — Flujo Checkout (Pasarela Centralizada)
Comportamiento por defecto para todos los integradores. Bajo esta modalidad, el endpoint de creación de transacciones dirige el recaudo hacia la cuenta recaudadora centralizada de CUCU SRL. CUCU actúa como intermediario fiduciario: recibe los fondos de las ventas del comercio, los acumula y posteriormente los dispersa a la cuenta bancaria registrada del comercio, aplicando de forma automática la deducción de la comisión por servicio establecida en el contrato comercial.Ventajas operativas
- Cero configuración adicional: cualquier integrador que obtenga credenciales opera bajo esta modalidad de manera inmediata.
- Conciliación automática: CUCU genera reportes de liquidación que el comercio puede consumir vía API o descargar desde el panel.
- Cobertura de riesgo: CUCU absorbe el riesgo de rechazo técnico y reintenta el procesamiento de forma transparente.
CUCU Direct — Flujo B2B Cuenta a Cuenta
Modalidad avanzada. Requiere habilitación comercial previa. CUCU Direct es una variación del procesamiento nativo donde los fondos impactan directamente en la cuenta bancaria del comercio en el momento en que la transacción es aprobada, sin pasar por la cuenta recaudadora central de CUCU.Habilitación de CUCU Direct
Esta modalidad requiere ajustes de configuración a nivel de cuenta en el backend de CUCU antes de que los endpoints respondan bajo este esquema. El proceso incluye:- Validación comercial y firma de addendum al contrato de servicio.
- Registro y verificación de la cuenta bancaria destino del comercio.
- Configuración de los parámetros de distribución en el sistema CUCU.
- Pruebas de integración en ambiente de staging antes del pase a producción.
Desde la perspectiva del código, la interfaz de la API es idéntica en ambas modalidades. No existen endpoints ni parámetros distintos para seleccionar el flujo. La diferencia es invisible para el desarrollador — opera a nivel de configuración de cuenta.