Multiples Capturas Parciales
Visión General
Multiples Capturas Parciales es una funcionalidad que permite a los comercios autorizar un monto total y capturarlo en múltiples partes a lo largo del tiempo. Esto es especialmente útil para modelos de negocio que requieren capturar pagos de forma progresiva — por ejemplo, emitir boletos a medida que se confirmen o cobrar cuando los artículos vuelvan a estar en inventario y listos para ser enviados.
Para utilizar esta funcionalidad, debes integrar Capture v2. Más información aquí.
Casos de Uso
Esta funcionalidad es especialmente útil para:
- Aerolíneas: Autorizar el monto total del boleto y capturar parcialmente a medida que se confirmen los asientos.
- Retail con envíos parciales: Ideal para marketplaces donde los pedidos son despachados por múltiples vendedores y los artículos se envían en diferentes momentos.
- Entrega de servicios por etapas: Capturar pagos conforme se completan las fases de un proyecto.
¿Cómo funciona?
- Autorización: El cliente autoriza el monto total de la transacción.
- Capturas múltiples: El comercio puede capturar parcialidades del monto autorizado en distintos momentos.
- Consolidación: El sistema gestiona las capturas múltiples y las envía al procesador de acuerdo a las reglas configuradas:
- Procesadores online: Las capturas se envían en tiempo real después de la autorización.
- Procesadores offline: Las capturas se envían posterior a la autorización, según se cumpla alguna de las siguientes condiciones:
- Se alcanza la fecha límite de captura definida.
- Se captura el monto total autorizado.
- El comercio envía
"final_capture": true
en la solicitud API.
Configuración y Requisitos
La funcionalidad de MPC requiere activación previa y los siguientes parámetros de configuración:
Configuración Principal
Parámetro | Descripción | Valores Permitidos | Valor por Defecto |
---|---|---|---|
Status | Activa o desactiva MPC | on / off | off |
Operating Time Zone | Zona horaria de operación para calcular los días hábiles | Zona horaria válida | UTC |
Capture Cutoff Days | Días permitidos para capturar después de la autorización | 0-45 | 7 |
Capture Cutoff via API | Permite indicar captura final usando "final_capture": true en la API | true / false | false |
Admin
El módulo de Admin permite:
- Configurar los parámetros de Multiple Partial Capture.
- Monitorear capturas pendientes.
- Consultar la fecha programada de procesamiento.
- Visualizar el monto restante disponible para captura.
Configuración en Admin
Para configurar Multiple Partial Captures desde el Admin:
- Accede al Portal de Admin.
- Dirígete a la sección Comercio y selecciona Configuraciones de Pagos.
- Habilita la opción Habilitar multiples capturas parciales.
- Define la ventana de captura (1 a 45 días posteriores a la autorización inicial).
Esta configuración aplica únicamente para el Modo Offline.
Los días configurados para captura parcial pueden ser modificados en cualquier momento. Sin embargo, los cambios no aplican sobre transacciones que ya hayan iniciado capturas parciales.

En el detalle de la orden se visualizará la fecha límite de captura. En dicha fecha, todas las capturas pendientes serán procesadas.

Modos de Operación
Modo Offline
- Aplica cuando el adquirente/procesador no gestiona capturas múltiples de forma nativa.
- Las capturas se consolidan y envían al procesador al cumplirse alguna de las siguientes condiciones:
- Se alcanza la fecha límite de captura.
- Se captura el monto total autorizado.
- El comercio envía
final_capture
con el valortrue
en la solicitud.
Ejemplo:
{
"amount": 100,
"final_capture": "true"
}
Status:
Mientras existan capturas pendientes, el status será partial capturing
.
Si se completa el monto total, el status cambiará a captured
.
Si se alcanza la fecha límite sin capturar el total, el status será partial captured
.
Procesadores bajo flujo de settlement (Elavon, Amex, UATP, BBVA)
Estos procesadores operan siempre en modo offline.
- El status permanece en
partial capturing
hasta que:- Se capture el total → status
capturing
→ post-settlement → statuscaptured
. - No se capture el total dentro del plazo → status
partial captured
.
- Se capture el total → status
Modo Online
- Las capturas se envían en tiempo real al procesador, si éste soporta MPC de forma nativa.
- Algunos procesadores requieren credenciales o habilitaciones específicas (por ejemplo: Stripe, Adyen).
Status
- Las capturas parciales generan status
partial captured
. - Al capturar el total, el status cambia automáticamente a
captured
.
Reglas
- La suma de todas las capturas no puede exceder el monto autorizado.
- No se permiten capturas fuera del período de elegibilidad ni después de enviar
"final_capture": true
.
Preguntas Frecuentes (FAQ)
¿Puedo modificar el período de elegibilidad después de la autorización?
No. El período de elegibilidad se define en el momento de la autorización y no puede modificarse posteriormente.
¿Qué ocurre si no capturo el monto total autorizado?
Al finalizar el período de elegibilidad o al utilizar el flag final_capture
, el monto restante será cancelado.
¿Existe un límite de capturas parciales?
- En Modo Offline, no hay límite técnico desde la plataforma.
- En Modo Online, los límites dependen de las reglas de cada procesador.
¿Puedo configurar el Modo Offline con cualquier procesador?
Sí. El Modo Offline puede ser configurado con cualquier procesador, incluso aquellos que soportan MPC de forma nativa.
¿Puedo configurar el Modo Online con cualquier procesador?
No requiere configuración desde Deuna. Durante la integración, se te indicará si el procesador soporta MPC. Algunos pueden requerir credenciales específicas o configuraciones adicionales del lado del cliente.
Updated 2 days ago