Suscripciones y pagos recurrentes
Seleccione quién gestiona los pagos recurrentes, implemente el motor de suscripciones de DEUNA y gestione planes, cargos, reintentos y cambios en el ciclo de vida de forma segura.
En esta página
DEUNA admite los pagos recurrentes a través del motor de suscripciones de DEUNA, un sistema de facturación de propiedad del comerciante, o mediante cargas por lotes recurrentes. Comience seleccionando quién decide qué cobrar y cuándo; esta decisión determina el modelo de integración y operación.
Seleccione quién gestiona la facturación#
El propietario de la facturación calcula cada importe y decide cuándo se debe cobrar. El procesamiento de pagos ejecuta esa instrucción. Elija un propietario principal para que dos sistemas no envíen la misma solicitud de cobro.
| Enfoque | Mejor ajuste | Propietario de facturación | Cómo se envía el cobro a DEUNA |
|---|---|---|---|
| Motor de suscripción DEUNA | Cargos fijos o basados en planes que DEUNA debe programar | DEUNA, según el plan configurado | El motor crea cada cargo programado |
| Motor de suscripción comercial | Importes variables o lógica de suscripción existente | Su sistema de facturación | Su backend llama a la API de pago de DEUNA |
| Carga por lotes recurrente | Sistemas heredados que preparan archivos de cobro | Su sistema de facturación o sistema heredado | Proporciona un lote acordado que contenga los tokens de DEUNA necesarios |
Motor de suscripción DEUNA
Configure el monto, la moneda, la frecuencia, el comportamiento de renovación, la opción de cargo inicial diferido y la política de reintento. Asocie un cliente y un método de pago compatible con un plan; DEUNA entonces programa los cargos.
El motor y la clasificación de pagos recurrentes deben estar habilitados para el comerciante y la tienda requeridos. El soporte del procesador, la portabilidad del token, la vinculación de transacciones de red y los requisitos de autenticación pueden limitar las conexiones elegibles para cargos posteriores.
Motor de suscripción comercial
Mantenga su lógica de facturación y utilice la API de pago DEUNA para cada recaudo. Su sistema sigue siendo responsable de calcular los montos, hacer cumplir el acuerdo, programar los recaudos y evitar duplicados.
DEUNA puede conservar los identificadores de transacciones de red compatibles para un posterior enlace de transacciones iniciado por el comerciante. Un token de "vault" identifica los credenciales de la tarjeta almacenados; un identificador de transacción de red hace referencia al historial de transacciones. Ninguno reemplaza el consentimiento del cliente, y la portabilidad depende del proveedor y de la red.
Carga por lotes recurrente
Utilice este modelo cuando una plataforma existente prepara los recaudos programados como archivos. Acuerde con DEUNA sobre el formato por lotes, la entrega segura, la idoneidad del token, los procesadores compatibles y el intercambio de resultados por pago antes de la implementación.
La recepción por lotes no es una aprobación de pago, y la autorización no es el cobro. Reconcile cada elemento con su resultado de pago final.
Ciclo de vida compartido de pagos recurrentes#
Los tres enfoques necesitan la misma base: acuerdo del cliente, un credencial compatible reutilizable, una decisión de facturación explícita, procesamiento de pagos y conciliación.
Pagos recurrentes, CIT y MIT
- Pago recurrente: un cargo que se cobra repetidamente de acuerdo con un acuerdo. El monto puede ser fijo, como una membresía, o variable, como el cobro basado en el uso.
- Transacción iniciada por el cliente (CIT): un pago que realiza el cliente activamente, incluyendo el primer pago completado durante el registro.
- Transacción iniciada por el comerciante (MIT): un pago posterior con tarjeta que su negocio inicia bajo el acuerdo previo sin que el cliente participe activamente en ese pago.
"Recurring" se refiere al patrón de cobro; "MIT" describe quién inicia el pago y bajo qué autoridad. Guardar una tarjeta por sí solo no autoriza cobros posteriores.
Por ejemplo, un cliente puede realizar el primer pago para una membresía mensual como "CIT" y autorizar renovaciones posteriores. Una renovación automática posterior es un "MIT". En su lugar, se puede tokenizar la tarjeta para un primer cobro diferido.
Consentimiento y autenticación
Mantener un acuerdo que identifique su negocio y explique el importe o cálculo, la frecuencia de cobro o el desencadenante, y los términos de cancelación. Capturar y tokenizar la tarjeta a través de un flujo compatible, con autenticación del cliente cuando sea necesario.
De acuerdo con la Segunda Directiva de Servicios de Pago (PSD2), los "MIT" cualificados pueden estar fuera de la autenticación fuerte del cliente (SCA), pero esto no es una exención general para los pagos recurrentes. La configuración remota requiere SCA bajo las condiciones aplicables. Consulte la Guía del MIT de la EBA y configurar 3D seguro (3DS) donde sea necesario.
Cobro fijo y variable
| Escenario | Acuerdo del cliente | Decisión de facturación |
|---|---|---|
| Membresía fija | Un importe definido en un horario recurrente | El plan configurado proporciona el importe y el intervalo de cobro |
| factura variable | Un importe calculado a partir del uso o precio revelado | El sistema de facturación del comerciante calcula el importe antes de cada cobro |
Si el importe puede cambiar, confirme qué sistema lo calcula y que el modelo seleccionado lo admita.
Motor de suscripción DEUNA#
El motor DEUNA organiza el cobro recurrente en torno a planes y suscripciones de clientes.
Ciclo de vida de un vistazo
Las transiciones aplicables dependen del plan, la política de cancelación o pausa, y la configuración de la cuenta. Reconciliar el resultado del pago antes de tratar a pending una suscripción como activa.
Referencia del plan
Un plan define los términos comerciales y de programación utilizados para las nuevas suscripciones.
| Configuración | Propósito |
|---|---|
| Nombre, descripción y grupo | Identificar y organizar la oferta |
| código de plan | Mapear el plan al identificador en su sistema |
| Importe y moneda | Definir la cuota fija para cada ciclo de cobro |
| Intervalo de cobro | Seleccionar con qué frecuencia DEUNA programa un cobro |
| Renovación automática | Determinar si la suscripción se renueva después de su plazo |
| Inicio diferido | Programar el primer cobro para una fecha posterior |
| Estado | Determinar si el plan está disponible para nuevas suscripciones |
Los intervalos de cobro admitidos son DAILY, WEEKLY, BIWEEKLY, THIRTY_DAYS, SIXTY_DAYS, NINETY_DAYS, MONTHLY, BIMESTRIAL, QUARTERLY, ANNUAL, BIENNIAL, TRIANNUALy BIANNUAL.
Referencia de la suscripción
Una suscripción conecta a un cliente con un plan y registra su ciclo de vida, método de pago, fechas de cobro y transacciones procesadas.
| Estado | Significado |
|---|---|
pending | Creada, pero su activación o primer cobro aplicable no se han completado |
active | Activada después de que se haya completado con éxito el pago requerido |
paused | Los futuros cobros programados están en suspenso hasta que se resuelva la suscripción |
canceled | La cancelación ha entrado en vigor según la política seleccionada |
expired o ended | El plazo configurado ha finalizado |
Primer cobro diferido
Un plan puede programar el primer cargo en lugar de realizarlo inmediatamente. Seleccione una de las opciones compatibles:
- Día específico del mes: realizar el cobro en el día configurado del calendario. Por ejemplo, una suscripción creada el 3 de octubre con el día 10 seleccionado, realizará el primer cobro el 10 de octubre.
- Número de días después de la adquisición: realizar la carga después del retraso configurado. Por ejemplo, una suscripción creada el 5 de octubre con un retraso de siete días realizará la primera carga el 12 de octubre.
La tarjeta se tokeniza cuando se crea la suscripción, aunque el cobro se inicia posteriormente. Esta regla de inicio diferido se aplica a las suscripciones creadas a partir de ese plan.
Política de reintento
Configurar el comportamiento de reintento desde Configuración de suscripciones Pestaña en el panel de administración:
- número máximo de intentos;
- intervalo de reintento y su unidad (minutos, horas o días);
- retroceso lineal o exponencial.
- transición a
pausedocanceleduna vez que se hayan agotado los intentos configurados.
La vista previa en el panel de administración muestra el horario de intentos calculado antes de guardarlo. Coordinar la propiedad de la recuperación con cualquier proceso de reintento del lado del comerciante para evitar que la misma factura se cobre dos veces.
Utilice la API de Suscripciones#
Utilice la autenticación con clave privada para las operaciones de suscripción. La API gestiona planes, suscripciones de clientes, cambios en las tarjetas almacenadas, acciones de ciclo de vida e historial.
| Tarea | Punto final |
|---|---|
| Crear o listar planes | Crear un plan · Listar planes |
| Obtener o actualizar un plan | Obtener un plan · Actualizar un plan |
| Crear o listar suscripciones | Crear una suscripción · Listar suscripciones |
| Obtener o actualizar una suscripción | Obtener una suscripción · Actualizar una suscripción |
| Reemplazar la tarjeta almacenada | Actualizar la tarjeta de suscripción |
| Suspender o reanudar el cobro | Pausa · Reanudar |
| Cancelar una suscripción | Cancelar |
| Revisar eventos del ciclo de vida | Obtener el historial de suscripciones |
Operación en el panel de administración#
Acceda a Suscripciones en el panel de administración de DEUNAEl usuario necesita acceso al módulo de Suscripciones; la creación de un plan también requiere la autorización "Crear plan".
Crear un plan
- Acceda a Suscripciones y seleccione el Planes tab.
- Seleccione Crear plano.
- Introduzca el nombre, código, descripción, grupo, importe, moneda, frecuencia y comportamiento de renovación del plan.
- Configurar un inicio diferido si la primera carga debe tener lugar más tarde.
- Revise la configuración y seleccione Guardar plan.
Confirme que el plan guardado está activo y aparece en la lista de Planes antes de asignar nuevas suscripciones.
Visualizar suscripciones y transacciones
- Abre el Suscripciones tab.
- Filtre por correo electrónico del cliente, fecha de creación, plan o estado.
- Abra una suscripción para revisar los detalles del cliente, el plan asociado, las fechas de facturación, el importe, el método de pago, las transacciones y el historial de ciclo de vida.
Utilice los resultados de la transacción, y no solo la presencia de una fila de suscripción, para verificar si la carga fue exitosa.
Suspender, reanudar o cancelar
Abra la suscripción, seleccione Accionesy elija la operación requerida.
| Política | Efecto |
|---|---|
| Inmediatamente | Aplique la pausa o cancelación ahora |
| Fin del período de facturación | Mantenga la suscripción activa durante el período actual, y luego aplique el cambio |
| Fecha específica | Programe el cambio para la fecha futura seleccionada |
Agregue una razón, si está disponible, para preservar el contexto operativo. Una suscripción pausada puede ser reanudada desde el mismo menú de Acciones. Después de cualquier acción, verifique el estado y la fecha efectiva en los detalles de la suscripción.
Recupere de forma segura las capturas de pago fallidas#
Primero, distinga entre un resultado sin resolver y un fallo confirmado. Nunca inicie una nueva captura mientras el pago original aún puede completarse.
- La autenticación del cliente debe devolver al flujo compatible; los intentos de reintento sin supervisión no lo reemplazan.
- El fallback del proveedor requiere una conexión válida y un dato de credencial que pueda utilizarse en esa ruta.
- Un reintento posterior debe cumplir con el acuerdo con el cliente, las reglas del procesador y la política de reintento configurada.
- Para fallos de comunicación, reconcile el pago original y siga las reglas técnicas de reintento documentadas.
Utilice la captura de tarjetas de DEUNA y Caja de Pago para tokenizar las credenciales y mantener los datos de la tarjeta originales fuera de los sistemas del comerciante. La externalización de la captura de tarjetas no elimina las responsabilidades de cumplimiento del comerciante.
Validar antes del lanzamiento#
Para resultados asíncronos, utilice ganchos web y obtenga el recurso original antes de actualizar sus registros.