Saltar al contenido principal
En esta página

DEUNA admite pagos recurrentes a través de su propio motor de suscripción, su sistema de facturación existente o cargas por lotes recurrentes. Esta página explica los conceptos detrás de los pagos recurrentes, lo ayuda a elegir un enfoque, documenta cómo funciona el motor de suscripción DEUNA, muestra cómo administrar planes y suscripciones en el Administrador y enumera qué validar antes del lanzamiento.

Conceptos clave#

Pagos recurrentes, MIT y CIT

Pagos recurrentes cobrar cargos repetidamente bajo un acuerdo con un cliente. El monto puede permanecer igual, como una membresía mensual, o cambiar, como una factura de servicios públicos según el uso. El cobro automático permite a los clientes pagar facturas posteriores sin completar manualmente cada pago.

un transacción iniciada por el comerciante (MIT) es un pago con tarjeta que su empresa inicia bajo un acuerdo previo, sin la participación activa del cliente en ese pago. un transacción iniciada por el cliente (CIT) es un pago que el cliente realiza activamente, incluso cuando elige pagar con una tarjeta guardada.

Recurrente describe las colecciones repetidas. El MIT describe quién inicia un pago y bajo qué autoridad. Los cobros automáticos de tarjetas recurrentes son un uso común del MIT, pero los términos no son intercambiables. Guardar una tarjeta por sí solo no autoriza cobros futuros.

Por ejemplo, un cliente se registra para obtener una membresía mensual hipotética de 10 USD. Pagan activamente los primeros 10 USD al registrarse y aceptan renovaciones mensuales automáticas. Ese pago de inscripción es un IRS. Al mes siguiente, tu negocio cobra la renovación acordada sin que el cliente haga nada: ese pago es un MIT. La configuración también puede guardar una tarjeta para un primer cargo diferido en lugar de cobrar al registrarse.

Suscripciones, facturación y procesamiento de pagos.

  • Suscripción: el acuerdo continuo entre un cliente y un plan de producto o servicio, incluidos los precios y los términos de cancelación.
  • Pagos recurrentes: los cargos cobrados en virtud de ese acuerdo.
  • Lógica de facturación: decide qué cobrar y cuándo.
  • Procesamiento de pagos: ejecuta esa instrucción a través de un proveedor de pago.

Elegir DEUNA para el procesamiento de pagos no transfiere todas las responsabilidades de gestión de suscripciones a DEUNA. Las políticas del cliente, los impuestos, las facturas y la prestación de servicios siguen siendo su responsabilidad a menos que se integren por separado.

Desde la configuración hasta la posterior recopilación

Los flujos de configuración y recuperación de esta página se centran en pagos recurrentes con tarjeta.

  1. Consentimiento: obtenga un consentimiento que identifique su negocio y explique el monto o cálculo, la frecuencia o activación del cobro y los términos de cancelación.
  2. Configuración de la tarjeta: captura y tokeniza la tarjeta, con autenticación del cliente cuando sea necesario. La configuración puede incluir un pago inmediato o guardar la tarjeta para un primer cargo diferido.
  3. Decisión de facturación: el propietario de la facturación determina el monto y la fecha de vencimiento de cada cobro según el acuerdo.
  4. Procesamiento: DEUNA procesa el pago.
  5. reconciliación: concilia cada resultado con tus registros.
Diagrama de flujo
1Customer consent2Card setup3Billing decision4DEUNA processes payment5Reconcile result
Comercio o clienteDEUNAResultado

Este ciclo de vida es conceptual. El enfoque elegido determina qué sistema programa o envía colecciones posteriores.

Reconoce tu escenario de pago#

EscenarioLo que el cliente acepta¿Qué desencadena la recolección?
Membresía fijaUn plan de streaming a 10 dólares al mesLa fecha de facturación mensual.
factura variableUna factura de servicios públicos de 40 USD un mes y 60 USD el siguiente, según el uso y el precio divulgados.La factura vence según el calendario acordado.

Para facturas variables, identifique qué sistema calcula el monto y confirme que el enfoque elegido admita esas reglas de facturación. Ambos escenarios requieren un acuerdo previo y una configuración de pago compatible.

Elija un enfoque DEUNA#

Elija según dónde pertenecen sus decisiones de facturación y cómo su sistema proporciona instrucciones de cobro.

EnfoqueMejor ajustePropietario de facturaciónCómo llega la recaudación a DEUNA
Motor de suscripción DEUNAQuieres que DEUNA programe cargos recurrentesMotor DEUNA, bajo tus términos configuradosEl motor activa cargas programadas.
Motor de suscripción comercialTu plataforma ya calcula y programa facturasSu motor actualSu sistema llama a la API de pago DEUNA
Carga por lotes recurrenteSu sistema heredado prepara archivos de recopilaciónSu sistema heredadoEnvía lotes utilizando tokens de bóveda DEUNA adecuados

Motor de suscripción DEUNA

Configure montos de facturación, monedas, frecuencias, renovación automática y reglas de reintento. Asocie clientes y métodos de pago con suscripciones para que el motor pueda programar y procesar cargos. Ver Cómo funciona el motor de suscripción de DEUNA abajo y Gestionar planes y suscripciones desde el Administrador para configuraciones admitidas, incluidos los primeros cargos diferidos.

El motor y su clasificación de pagos recurrentes deben estar habilitados para el comerciante y la tienda requeridos. El soporte del procesador, la portabilidad del token, el enlace de transacción de red y los requisitos de autenticación pueden limitar qué conexiones son elegibles para cargos posteriores.

Motor de suscripción comercial

Mantenga su lógica de facturación y utilice la API de pago DEUNA para colección. DEUNA proporciona enrutamiento, reintentos entre proveedores elegibles y manejo de pagos para flujos MIT y PSD2, incluido el 3DS inicial cuando sea necesario. Configurar estrategias de pago para conexiones admitidas.

DEUNA también almacena identificadores de transacciones de red (NTID) para su posterior vinculación con MIT. Un token de bóveda identifica las credenciales de la tarjeta almacenadas; un NTID hace referencia al historial de transacciones de la red. Ninguno de los dos reemplaza el consentimiento del cliente y el enlace admitido depende del proveedor y la red.

Carga por lotes recurrente

DEUNA puede enviar colecciones por lotes basadas en tokens para la autorización del procesador en línea cuando sea compatible. Un lote cambia la forma en que llegan las instrucciones; La autorización aún puede realizarse en línea para cada pago.

Acuerde el formato de lote recurrente, la entrega, la idoneidad del token, los procesadores y el intercambio de resultados por pago con DEUNA antes de la integración.

Cómo funciona el motor de suscripción de DEUNA#

El API de suscripciones gestiona las suscripciones de los clientes a los planes que ofreces. Úselo para controlar los estados de suscripción y plan y para garantizar que la facturación, activación, cancelación y vencimiento se realicen correctamente.

También puede crear planes y administrar suscripciones desde el módulo Suscripciones en el Administrador. Ver Gestionar planes y suscripciones desde el Administrador para la guía paso a paso.

modelo de datos

ObjectDescripciónContiene
PlanificarProducto o servicio ofrecido a los clientes.Código único, nombre, descripción, nombre del grupo, monto, moneda, intervalo de facturación, renovación automática, inicio diferido opcional, estado
SuscripciónRelación entre un cliente y un planID único, estado y fechas de creación, activación, cancelación y vencimiento
ciclo de facturaciónPeriodo de tiempo en el que se cobra un planUno de los intervalos de facturación admitidos (ver más abajo)

Inicio diferido

Un plan puede definir cuándo se produce el primer cargo en lugar de cobrar inmediatamente, ya sea en un día específico del mes o una cantidad determinada de días después de que se crea la suscripción. Solo se puede configurar un modo de inicio diferido por plan.

  • No se realiza ningún cargo inmediato.
  • Los cargos se programan automáticamente según la configuración del plan, sin llamadas API adicionales.
  • No se admite la edición del plan y el inicio diferido no se puede cambiar una vez que el plan tiene suscripciones activas.

Consulta Crear un plan con inicio diferido para conocer los pasos y ejemplos de configuración del administrador.

Intervalos de facturación admitidos

ValorFrecuencia
DAILYDiario
WEEKLYSemanal
BIWEEKLYCada dos semanas
THIRTY_DAYSCada 30 días
SIXTY_DAYSCada 60 días
NINETY_DAYSCada 90 días
MONTHLYMensual
BIMESTRIALCada 2 meses
QUARTERLYCada 3 meses
ANNUALAnualmente
BIENNIALCada 2 años
TRIANNUAL3 veces al año
BIANNUAL2 veces al año

Estados del plan

EstadoDescripción
activeEl plan está activo y disponible para nuevas suscripciones.
pendingSe intentó crear el plan, pero no se completó debido a una falla interna del sistema.

Estados de suscripción

EstadoDescripción
pendingLa suscripción fue creada, pero aún no se ha realizado el cargo. Permanece en este estado hasta que la carga tiene éxito o fracasa.
activeEl pago se completó exitosamente y la suscripción fue validada.
canceledEl cliente o el comerciante canceló explícitamente la suscripción antes de su vencimiento.
expiredLa suscripción finalizó, ya sea porque llegó a su fecha de vencimiento o porque fue cancelada.

Gestionar suscripciones con la API

Crear una suscripción

Usa la Crear una suscripción endpoint.

Listar suscripciones

Usa la Obtener lista de suscripción punto final para recibir todas las suscripciones de un cliente.

Actualizar una suscripción o tarjeta de pago

Si el cliente actualiza su tarjeta podrá:

Capture tarjetas de reemplazo mediante la captura segura de tarjetas para que los datos sin procesar de las tarjetas permanezcan fuera de sus sistemas.

Cancelar una suscripción

La cancelación cambia el estado a canceled. Puedes especificar:

  • Cancelación al final del ciclo de facturación actual.
  • Cancelación al final del ciclo de renovación. Por ejemplo, una suscripción mensual renovada por un año se cancela cuando se completa ese año.
  • term_end: indica el final del ciclo actual y genera un reembolso.
  • bill_date: indica el inicio del siguiente ciclo (24 horas después term_end) y genera un reembolso.

Para conocer los pasos de administración coincidentes, consulte Cancelar una suscripción en el Administrador.

Reintentos automáticos

El motor de suscripción incluye un mecanismo de reintento para manejar fallas temporales, como problemas de comunicación con los procesadores de pago durante el cobro o la activación de la suscripción. Garantiza que el pago y la activación se completen sin intervención manual, incluso con fallas intermitentes.

  • Reintento automático: si falla el cobro o la activación de la suscripción, el sistema intenta el proceso nuevamente después de un retraso.
  • Retroceso exponencial: cada reintento aumenta el tiempo de espera entre intentos para evitar sobrecargar el sistema.
  • Límite de reintentos: cuando los reintentos alcanzan un máximo configurable (por ejemplo, seis intentos), el sistema marca la suscripción como pausada o cancelada (según su propia configuración)
  • Notificación: después de intentos fallidos, el sistema puede notificar al cliente o administrador sobre el estado de la suscripción y las fallas.
Intentotiempo de espera
1—
25 minutos
360 minutos
45 horas
512 horas
6De 24 horas

Gestionar planes y suscripciones desde el Administrador#

Los planes definen las condiciones de facturación de una suscripción, incluido su precio, frecuencia, tipo de renovación y, opcionalmente, una fecha de inicio diferida para el cobro. Gestionas tanto los planes como las suscripciones de clientes desde la Suscripciones módulo en el Administrador.

Campos del plan

CapacidadDescripción
Nombre del planNombre comercial identificativo del plan (Plan Premium).
Descripción del planoTexto opcional que detalla lo que incluye el plan ("Acceso ilimitado a contenido premium").
Nombre del grupoAgrupación interna para planes similares (Premium, Básico, Anual). Útil para la organización.
código de planIdentificador único del plan en su sistema (PLAN-001).
Monto del planEl valor cobrado en cada ciclo de facturación.
MonedaDetermina la moneda en la que se cobra el plan.
FrecuenciaFrecuencia de facturación (semanal, mensual, anual, cada 2 meses, etc.). Ver Intervalos de facturación admitidos.
Renovación automáticaDefine si las suscripciones asociadas se renuevan cuando finaliza su período.
Inicio diferidoPermite definir cuándo ocurrirá el primer cobro, sin realizar pago inmediato.
EstadoActivo: disponible para asignar a nuevas suscripciones. Pendiente: el plan no se puede asignar a nuevas suscripciones.

Crear un plan con inicio diferido

  1. En el menú de la barra lateral, vaya a Suscripciones.
  2. En Suscripciones, haga clic en Planes.
  3. Clic Crear plano.
  4. Completa los campos generales del plan: nombre, descripción, monto, moneda, frecuencia y renovación.
  5. En el Inicio diferido sección, active la "Programar inicio de facturación" toggle.
  6. Seleccione cómo desea definir el inicio de facturación:
    • En un día específico del mes: el cargo se producirá el mismo dia todos los meses, independientemente de cuándo se creó la suscripción.

      Ejemplo: si seleccionas el día 10 y el usuario se suscribe el 3 de octubre, el primer cobro será el 10 de octubre.

    • X días después de adquirir el plan: el cargo se producirá X días después se crea la suscripción.

      Ejemplo: si eliges 7 días y la suscripción comienza el 5 de octubre, el periodo de inicio de suscripción será el 12 de octubre.

  7. Guarde los cambios haciendo clic Guardar plan.

El inicio diferido se registrará y se aplicará a todas las suscripciones creadas con este plan.

Ver suscripciones

Accede al Suscripciones pestaña dentro del módulo.

CampoDescripción
Subscription IDIdentificador de suscripción único.
Correo electrónico del clienteCorreo electrónico asociado a la suscripción.
Nombre del planPlan activo al que está suscrito el usuario.
Importe por facturaValor cobrado periódicamente por la suscripción.
Inicio de suscripciónFecha en que se activó la suscripción.
última fecha de pagoFecha del último intento de facturación.
EstadoEstado actual: Active, Cancelled, Expired, Pending.

Puedes filtrar las suscripciones por correo electrónico del cliente, fecha de creacióno nombre del plan.

Detalles de suscripción

Haga clic en cualquier suscripción de la lista para acceder a su vista detallada.

SecciónDescripción
Datos del clienteInformación básica: nombre, correo electrónico, ID de cliente.
Detalles de suscripciónEstado actual, fechas clave, plan asociado, monto y frecuencia de facturación.
TransaccionesLista de cargos procesados para esa suscripción. Incluye ID de transacción, fecha, monto, procesador y estado de pago.

Cancelar una suscripción en el Administrador

  1. Ir al Suscripciones sección en el menú de la barra lateral.
  2. En el Suscripciones pestaña, busque el cliente por correo electrónico o ID.
  3. Haga clic en el icono del menú de acciones ··· y seleccione Ver suscripción.
  4. En la vista detallada, haga clic en Acciones botón y seleccione Cancelar.
  5. Se abrirá un modal con la opción de seleccionar un Política de cancelación. Hay tres opciones:
Política de cancelaciónDescripción
Cancelar inmediatamenteFinaliza la suscripción de inmediato.
Cancelar al final del período de facturaciónMantiene la suscripción activa hasta que finalice el ciclo actual. Se cancela automáticamente al final del período.
Cancelar en una fecha específicaPermite definir manualmente una fecha de cancelación futura. Hasta esa fecha la suscripción permanece activa.
  1. Si elige la opción de fecha específica, seleccione el día en el calendario.
  2. (Opcional) Agregue un motivo de cancelación para mantener la trazabilidad.
  3. Clic Confirmar cancelación para ejecutar la acción.

Pausar una suscripción

  1. En el detalle de la suscripción, haga clic en Acciones botón y seleccione Pausa.
  2. Aparecerá un modal donde podrás elegir el Pausar política. Hay tres opciones:
Pausar políticaDescripción
Pausa inmediatamenteSuspende la suscripción de inmediato. No se generan más cargos hasta que se reactive.
Pausa al final del período de facturaciónMantiene la suscripción activa hasta el final del ciclo actual y luego la pausa automáticamente.
Pausa en una fecha específicaPrograma la pausa para una fecha futura. Hasta ese día la suscripción permanece activa.
  1. Si elige la opción de fecha específica, seleccione el día en el calendario.
  2. (Opcional) Introduzca un razón de pausa si desea registrar el contexto.
  3. Clic Confirmar pausa para aplicar la acción.

Beneficios para cobros recurrentes#

Reintentar el tiempo informado por el comportamiento

Los reintentos impulsados por IA de DEUNA aprenden del comportamiento histórico de comerciantes y clientes para seleccionar el momento de los intentos de recuperación elegibles. En comparación con un programa de reintentos fijo, esto puede apuntar a un momento en el que una condición recuperable pueda haber cambiado. Por ejemplo, un intento posterior puede tener éxito después de que se reponga un saldo insuficiente.

El objetivo es recuperar ingresos y reducir la deserción involuntaria: los clientes se pierden porque fallan los pagos. La aprobación no está garantizada. Confirme las funciones de recuperación disponibles y los límites del proveedor o de la red para el enfoque elegido.

Resiliencia a través de múltiples proveedores

El enrutamiento a través de proveedores elegibles configurados reduce la dependencia de una única conexión de procesamiento. Procesamiento predeterminado Puede utilizar un segundo procesador en una cascada alternativa. La elegibilidad depende del error, las reglas del proveedor y la idoneidad del token para la ruta alternativa. Cambiar de proveedor no repone un saldo insuficiente.

Si una recopilación no tiene éxito confirmado, primero distinga un resultado no resuelto de un resultado que permite la recuperación:

Diagrama de flujo
Unknown or pendingCustomer action requiredConfirmed failureNoneEligible providerEligible later attempt1Collection result2Reconcile originalpayment3Customer action4Allowed recovery5Stop automatic recovery6Provider fallback7Retry later
ResultadoComercio o clienteExcepción o detenciónProveedor o procesadorRevisión o pendiente

Cada ruta de recuperación depende del acuerdo, las reglas del proveedor y la configuración admitida:

  • Utilice un flujo de clientes admitido solo si está permitido. La autenticación del cliente requerida debe devolver al cliente al flujo admitido; los reintentos desatendidos no pueden reemplazarlo.
  • El respaldo del proveedor requiere un proveedor elegible configurado.
  • Un reintento de recolección posterior debe ser elegible y ocurrir en el momento seleccionado.
  • Los reintentos técnicos después de fallas de comunicación siguen reglas documentadas para el pago original.

Coordine la propiedad de la recuperación entre su sistema y DEUNA para evitar que procesos independientes cobren la misma factura dos veces.

Datos de tarjetas menos confidenciales en sus sistemas

Utilice la captura de tarjetas de DEUNA y Caja de Pago para tokenizar credenciales y mantener los datos de tarjetas sin procesar fuera de sus sistemas. Esto puede reducir los controles aplicables según el Estándar de seguridad de datos de la industria de tarjetas de pago (PCI DSS). La subcontratación aún deja responsabilidades a los comerciantes, incluida la supervisión del proveedor y la validación del cumplimiento. Ver Guía de subcontratación de PCI SSC.

Prepárese para la adopción#

Confirme el propietario de la facturación, el flujo de consentimiento, los proveedores admitidos, la idoneidad del token y la política de recuperación. Si una tarjeta queda inutilizable, solicite al cliente que la reemplace mediante la captura segura de la tarjeta.

Para resultados inciertos, concilie el pago original antes de iniciar un nuevo cobro. Sigue el orientación de solicitud idempotente para reintentos técnicos después de fallas de comunicación. Utilice canales de resultados documentados, incluidos ganchos web cuando corresponda, para actualizar sus registros.

Manejo de cancelación

Distinguir una solicitud de cancelación desde su momento de vigencia: inmediata, fin de período o fecha especificada según la política configurada.

  • Detener nuevos envíos a partir de ese momento, o antes si la autoridad de cobro se revoca o vence.
  • Elimine las colecciones afectadas no enviadas del sistema de programación.
  • Conciliar los pagos ya enviados. No asuma que la cancelación detiene un pago durante el vuelo; confirmar cualquier reversión o reembolso según la política aplicable.

Validar antes del lanzamiento

Utilice casos de zona de pruebas compatibles. Coordinar los casos no disponibles con la DEUNA antes del lanzamiento.

  • Configuración: confirme el consentimiento retenido, un token adecuado y la finalización de la autenticación requerida.
  • Colección: verifique que el monto coincida con la decisión de facturación y que cada resultado concuerde con sus registros.
  • Recuperación: ejercite resultados elegibles de recuperación y autenticación requerida. Confirme la política acordada y el flujo de acción del cliente.
  • Resultado incierto: verificar la conciliación antes de otro intento de cobro.
  • Cancelación: verifique la política de tiempo efectivo, el consentimiento revocado, la eliminación de los cobros en cola afectados y la conciliación de los pagos enviados.

Próximos pasos#