Saltar al contenido principal
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.

EnfoqueMejor ajustePropietario de facturaciónCómo se envía el cobro a DEUNA
Motor de suscripción DEUNACargos fijos o basados en planes que DEUNA debe programarDEUNA, según el plan configuradoEl motor crea cada cargo programado
Motor de suscripción comercialImportes variables o lógica de suscripción existenteSu sistema de facturaciónSu backend llama a la API de pago de DEUNA
Carga por lotes recurrenteSistemas heredados que preparan archivos de cobroSu sistema de facturación o sistema heredadoProporciona un lote acordado que contenga los tokens de DEUNA necesarios
Motor de suscripción DEUNAProgramación basada en planes

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 comercialSu sistema programa cada pago

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 recurrenteRecaudo basado en archivos

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.

Diagrama de flujo
1Customer agreement2Card capture andsetup3Billing ownercalculates amountand due date4DEUNA processespayment5Merchant reconcilesfinal result
Comercio o clienteResultadoDEUNA
Pagos recurrentes, CIT y MITTérminos clave
  • 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.

Cobro fijo y variableDefinir el importe
EscenarioAcuerdo del clienteDecisión de facturación
Membresía fijaUn importe definido en un horario recurrenteEl plan configurado proporciona el importe y el intervalo de cobro
factura variableUn importe calculado a partir del uso o precio reveladoEl 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

Diagrama de flujo
Activation succeedsPause policy takeseffectResumeCancellation takeseffectTerm completes1Plan available2Subscription pending3Active4Paused5Canceled6Expired or ended
Revisión o pendienteExcepción o detención

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 planCampos e intervalos de cobro

Un plan define los términos comerciales y de programación utilizados para las nuevas suscripciones.

ConfiguraciónPropósito
Nombre, descripción y grupoIdentificar y organizar la oferta
código de planMapear el plan al identificador en su sistema
Importe y monedaDefinir la cuota fija para cada ciclo de cobro
Intervalo de cobroSeleccionar con qué frecuencia DEUNA programa un cobro
Renovación automáticaDeterminar si la suscripción se renueva después de su plazo
Inicio diferidoProgramar el primer cobro para una fecha posterior
EstadoDeterminar 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ónEstados y relación con el cliente

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.

EstadoSignificado
pendingCreada, pero su activación o primer cobro aplicable no se han completado
activeActivada después de que se haya completado con éxito el pago requerido
pausedLos futuros cobros programados están en suspenso hasta que se resuelva la suscripción
canceledLa cancelación ha entrado en vigor según la política seleccionada
expired o endedEl plazo configurado ha finalizado
Primer cobro diferidoDía específico o número de días

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 reintentoIntentos, tiempos y estado final

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 paused o canceled una 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.

TareaPunto final
Crear o listar planesCrear un plan · Listar planes
Obtener o actualizar un planObtener un plan · Actualizar un plan
Crear o listar suscripcionesCrear una suscripción · Listar suscripciones
Obtener o actualizar una suscripciónObtener una suscripción · Actualizar una suscripción
Reemplazar la tarjeta almacenadaActualizar la tarjeta de suscripción
Suspender o reanudar el cobroPausa · Reanudar
Cancelar una suscripciónCancelar
Revisar eventos del ciclo de vidaObtener 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 planProcedimiento de administración
  1. Acceda a Suscripciones y seleccione el Planes tab.
  2. Seleccione Crear plano.
  3. Introduzca el nombre, código, descripción, grupo, importe, moneda, frecuencia y comportamiento de renovación del plan.
  4. Configurar un inicio diferido si la primera carga debe tener lugar más tarde.
  5. 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 transaccionesFiltros y detalles
  1. Abre el Suscripciones tab.
  2. Filtre por correo electrónico del cliente, fecha de creación, plan o estado.
  3. 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 cancelarCambios inmediatos o programados

Abra la suscripción, seleccione Accionesy elija la operación requerida.

PolíticaEfecto
InmediatamenteAplique la pausa o cancelación ahora
Fin del período de facturaciónMantenga la suscripción activa durante el período actual, y luego aplique el cambio
Fecha específicaPrograme 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.

Diagrama de flujo
Unknown or pendingCustomer actionrequiredConfirmed failureNoEligible providerEligible later attempt1Collection result2Reconcile originalpayment3Return customer tosupported flow4Recovery allowed?5Stop automaticrecovery6Use configuredprovider fallback7Retry under oneowner and policy
ResultadoComercio o clienteExcepción o detenciónProveedor o procesadorRevisión o pendiente
  • 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.

Próximos pasos#