Suscripciones y pagos recurrentes
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.
- 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.
- 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.
- 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.
- Procesamiento: DEUNA procesa el pago.
- reconciliación: concilia cada resultado con tus registros.
Este ciclo de vida es conceptual. El enfoque elegido determina qué sistema programa o envía colecciones posteriores.
Reconoce tu escenario de pago#
| Escenario | Lo que el cliente acepta | ¿Qué desencadena la recolección? |
|---|---|---|
| Membresía fija | Un plan de streaming a 10 dólares al mes | La fecha de facturación mensual. |
| factura variable | Una 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.
| Enfoque | Mejor ajuste | Propietario de facturación | Cómo llega la recaudación a DEUNA |
|---|---|---|---|
| Motor de suscripción DEUNA | Quieres que DEUNA programe cargos recurrentes | Motor DEUNA, bajo tus términos configurados | El motor activa cargas programadas. |
| Motor de suscripción comercial | Tu plataforma ya calcula y programa facturas | Su motor actual | Su sistema llama a la API de pago DEUNA |
| Carga por lotes recurrente | Su sistema heredado prepara archivos de recopilación | Su sistema heredado | Enví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
| Object | Descripción | Contiene |
|---|---|---|
| Planificar | Producto 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ón | Relación entre un cliente y un plan | ID único, estado y fechas de creación, activación, cancelación y vencimiento |
| ciclo de facturación | Periodo de tiempo en el que se cobra un plan | Uno 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
| Valor | Frecuencia |
|---|---|
DAILY | Diario |
WEEKLY | Semanal |
BIWEEKLY | Cada dos semanas |
THIRTY_DAYS | Cada 30 días |
SIXTY_DAYS | Cada 60 días |
NINETY_DAYS | Cada 90 días |
MONTHLY | Mensual |
BIMESTRIAL | Cada 2 meses |
QUARTERLY | Cada 3 meses |
ANNUAL | Anualmente |
BIENNIAL | Cada 2 años |
TRIANNUAL | 3 veces al año |
BIANNUAL | 2 veces al año |
Estados del plan
| Estado | Descripción |
|---|---|
active | El plan está activo y disponible para nuevas suscripciones. |
pending | Se intentó crear el plan, pero no se completó debido a una falla interna del sistema. |
Estados de suscripción
| Estado | Descripción |
|---|---|
pending | La 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. |
active | El pago se completó exitosamente y la suscripción fue validada. |
canceled | El cliente o el comerciante canceló explícitamente la suscripción antes de su vencimiento. |
expired | La 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á:
- llamar Suscripción de actualización para actualizar la suscripción.
- Vuelva a intentar el cargo de la factura vencida.
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ésterm_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.
| Intento | tiempo de espera |
|---|---|
| 1 | — |
| 2 | 5 minutos |
| 3 | 60 minutos |
| 4 | 5 horas |
| 5 | 12 horas |
| 6 | De 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
| Capacidad | Descripción |
|---|---|
| Nombre del plan | Nombre comercial identificativo del plan (Plan Premium). |
| Descripción del plano | Texto opcional que detalla lo que incluye el plan ("Acceso ilimitado a contenido premium"). |
| Nombre del grupo | Agrupación interna para planes similares (Premium, Básico, Anual). Útil para la organización. |
| código de plan | Identificador único del plan en su sistema (PLAN-001). |
| Monto del plan | El valor cobrado en cada ciclo de facturación. |
| Moneda | Determina la moneda en la que se cobra el plan. |
| Frecuencia | Frecuencia de facturación (semanal, mensual, anual, cada 2 meses, etc.). Ver Intervalos de facturación admitidos. |
| Renovación automática | Define si las suscripciones asociadas se renuevan cuando finaliza su período. |
| Inicio diferido | Permite definir cuándo ocurrirá el primer cobro, sin realizar pago inmediato. |
| Estado | Activo: disponible para asignar a nuevas suscripciones. Pendiente: el plan no se puede asignar a nuevas suscripciones. |
Crear un plan con inicio diferido
- En el menú de la barra lateral, vaya a Suscripciones.
- En Suscripciones, haga clic en Planes.
- Clic Crear plano.
- Completa los campos generales del plan: nombre, descripción, monto, moneda, frecuencia y renovación.
- En el Inicio diferido sección, active la "Programar inicio de facturación" toggle.
- 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.
-
- 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.
| Campo | Descripción |
|---|---|
| Subscription ID | Identificador de suscripción único. |
| Correo electrónico del cliente | Correo electrónico asociado a la suscripción. |
| Nombre del plan | Plan activo al que está suscrito el usuario. |
| Importe por factura | Valor cobrado periódicamente por la suscripción. |
| Inicio de suscripción | Fecha en que se activó la suscripción. |
| última fecha de pago | Fecha del último intento de facturación. |
| Estado | Estado 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ón | Descripción |
|---|---|
| Datos del cliente | Información básica: nombre, correo electrónico, ID de cliente. |
| Detalles de suscripción | Estado actual, fechas clave, plan asociado, monto y frecuencia de facturación. |
| Transacciones | Lista 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
- Ir al Suscripciones sección en el menú de la barra lateral.
- En el Suscripciones pestaña, busque el cliente por correo electrónico o ID.
- Haga clic en el icono del menú de acciones
···y seleccione Ver suscripción. - En la vista detallada, haga clic en Acciones botón y seleccione Cancelar.
- Se abrirá un modal con la opción de seleccionar un Política de cancelación. Hay tres opciones:
| Política de cancelación | Descripción |
|---|---|
| Cancelar inmediatamente | Finaliza la suscripción de inmediato. |
| Cancelar al final del período de facturación | Mantiene la suscripción activa hasta que finalice el ciclo actual. Se cancela automáticamente al final del período. |
| Cancelar en una fecha específica | Permite definir manualmente una fecha de cancelación futura. Hasta esa fecha la suscripción permanece activa. |
- Si elige la opción de fecha específica, seleccione el día en el calendario.
- (Opcional) Agregue un motivo de cancelación para mantener la trazabilidad.
- Clic Confirmar cancelación para ejecutar la acción.
Pausar una suscripción
- En el detalle de la suscripción, haga clic en Acciones botón y seleccione Pausa.
- Aparecerá un modal donde podrás elegir el Pausar política. Hay tres opciones:
| Pausar política | Descripción |
|---|---|
| Pausa inmediatamente | Suspende la suscripción de inmediato. No se generan más cargos hasta que se reactive. |
| Pausa al final del período de facturación | Mantiene la suscripción activa hasta el final del ciclo actual y luego la pausa automáticamente. |
| Pausa en una fecha específica | Programa la pausa para una fecha futura. Hasta ese día la suscripción permanece activa. |
- Si elige la opción de fecha específica, seleccione el día en el calendario.
- (Opcional) Introduzca un razón de pausa si desea registrar el contexto.
- 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:
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#
- Motor de suscripción DEUNA: configura tus planes desde el página de administración e integrar el API de suscripciones.
- Motor de suscripción comercial: integrar el API de pago DEUNA y configurar estrategias de pago.
- Carga por lotes recurrente: acordar la recogida e intercambio de resultados con la DEUNA antes de construir la integración.