Multiples capturas parciales (MPC)

Qué es MPC

Multiples capturas parciales (MPC) es una funcionalidad que te autorizar un monto total y capturarlo en múltiples partes a lo largo del tiempo.

Sirve 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, integrate con Crear Pagos V2.

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.

📘

El Modo Offline puede ser configurado con cualquier procesador, incluso aquellos que soportan MPC de forma nativa.

Durante la integración, se te indicará si el procesador soporta MPC. Algunos procesadores pueden requerir credenciales específicas o configuraciones adicionales.

Cómo funciona MPC

Un flujo MPC funciona de la siguiente forma:

  1. Autorización: El cliente autoriza el monto total de la transacción.
  2. Capturas múltiples: La tienda captura partes del monto autorizado en distintas fechas.
  3. 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 tras 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 MPC requiere activación previa y los siguientes parámetros de configuración:

Configuración principal

La siguiente tabla documenta la configuración principal para MPC:

ParámetroDescripciónValores PermitidosValor por Defecto
StatusActiva o desactiva MPCon / offoff
Operating Time ZoneZona horaria de operación para calcular los días hábilesZona horaria válidaUTC
Capture Cutoff DaysDías permitidos para capturar después de la autorización0-457
Capture Cutoff via APIPermite indicar captura final usando "final_capture": true en la APItrue / falsefalse

Configura MPC en el Admin

Realiza las siguientes tareas de MPC en el Admin:

  • Configura los parámetros de MPC.
  • Monitorea capturas pendientes.
  • Consulta la fecha programada de procesamiento.
  • Visualiza el monto restante disponible para captura.

Para configurar Multiple Partial Captures desde el Admin:

  1. Accede al Portal de Admin.
  2. Dirígete a la sección Comercio.
  3. Delecciona Configuraciones de Pagos.
  4. Habilita la opción Habilitar multiples capturas parciales.
  5. Define la ventana de captura: De 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.

📘

El período de elegibilidad se define en el momento de la autorización y no puede modificarse posteriormente.

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

📘

Al finalizar el período de elegibilidad o al utilizar el flag final_capture, el monto restante será cancelado.

Modos de operación

Descubre cómo operar MCP con DEUNA.

Límitesde capturas parciales:*

  • Modo Offline: No hay límite técnico desde la plataforma.
  • Modo Online: Los límites dependen de las reglas de cada procesador.

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:

  1. Se alcanza la fecha límite de captura.
  2. Se captura el monto total autorizado.
  3. El comercio envía final_capture con el valor true 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 m/odo offline.

El status permanece en partial capturing hasta que:

  • Se capture el total → status capturing → post-settlement → status captured.
  • No se capture el total dentro del plazo → status partial captured.

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.

Procesadores soportados:

Flujo Offline:

  • Stripe, Elavon, Worldpay