Saltar al contenido principal
En esta página

Las múltiples capturas parciales (MPC) le permiten autorizar un monto una vez y capturarlo en varias solicitudes. Úselo cuando la entrega se realiza en etapas, por ejemplo, cuando se confirman los boletos, se envían los productos o se completan los hitos del servicio.

La MPC se configura por conexión con el procesador. La conexión debe admitir la autorización y la captura, y DEUNA debe activar el modo de operación apropiado para esa conexión.

Para usar la MPC, integre con Crear pagos V2 y cree el pago utilizando la autorización en lugar de la captura automática.

Seleccione un modo de operación#

ModoCuando se contacta al procesadorControl gestionado por DEUNAfinal_capture comportamiento
En líneaCada solicitud de captura se envía inmediatamente al procesador.NoIgnorada por el flujo de MPC en línea. La secuencia se cierra cuando la cantidad acumulada capturada alcanza el importe autorizado o según las reglas del procesador.
Sin conexiónLas solicitudes no finales se almacenan en cola. DEUNA envía la cantidad acumulada capturada cuando la secuencia se cierra.SíCierra la secuencia y envía la cantidad acumulada.

El modo en línea solo es apropiado cuando la conexión con el procesador admite múltiples capturas de forma nativa. El modo fuera de línea es el modo de compatibilidad gestionado por DEUNA y también se puede seleccionar para un procesador con MPC nativo cuando el negocio requiere el procesamiento por lotes.

Ciclo de vida del MPC fuera de línea#

  1. El pago llega authorized.
  2. Cada captura no final se valida contra el importe autorizado restante y se almacena sin llamar al procesador.
  3. Mientras que una o más cantidades de captura están en cola, el pago es partial_capturing.
  4. DEUNA cierra la secuencia cuando se cumplen las siguientes condiciones:
    • La cantidad solicitada acumulada alcanza el importe autorizado.
    • Una solicitud incluye "final_capture": true.
    • Se alcanza el límite de captura guardado.
  5. DEUNA envía la cantidad acumulada neta de captura al procesador como una única operación de captura.
  6. Si el importe total confirmado es igual al importe autorizado, el pago se convierte en captured. Si el importe total confirmado es inferior, se convierte en partial_captured.

Cerrar una secuencia por debajo del importe autorizado marca la secuencia de captura de DEUNA como final. Las solicitudes de captura posteriores son rechazadas. Consulte con su responsable técnico de DEUNA (TAM) cómo se libera el importe autorizado restante por el procesador seleccionado.

Cerrar la secuencia a través de la API

enviar final_capture como un booleano JSON, no como una cadena:

JSON
{
  "amount": 100,
  "final_capture": true
}

El amount es la cantidad de esta solicitud de captura. En modo offline, DEUNA la añade a las cantidades de captura previamente almacenadas antes de enviar la solicitud consolidada al procesador.

Límites de corte y tiempo para la captura#

El límite de corte para la captura offline tiene estas reglas:

  • Configurar un número entero de 1 a 45 días calendario.
  • DEUNA guarda la fecha límite absoluta en capture_cutoff_at . Para el pago, use esta marca de tiempo, cuando se devuelva, como fuente de verdad en lugar de calcular la fecha límite localmente.
  • En los flujos de autorización que definen el momento de finalización de la autorización, el contador se inicia en el momento de la autorización. Si aún no existe un límite de tiempo, el flujo de captura lo establece cuando se registra la primera transacción de captura no final.
  • El plazo finaliza al final del día calendario de destino, no en un número exacto de períodos de 24 horas después de la solicitud.
  • Las capturas parciales posteriores no extienden ni restablecen la fecha límite guardada.
  • Modificar la configuración de conexión no reescribe una fecha límite ya guardada en un pago existente.
  • Cuando se alcanza la fecha límite guardada, el pago se vuelve elegible para que el trabajador de corte cierre la secuencia en cola. El procesamiento no está garantizado en el segundo exacto del día, por lo que no se debe confiar en un período de gracia para otro comerciante.

La MPC en línea no tiene un corte de captura de DEUNA. Los límites de validez de autorización y captura del procesador siguen aplicándose.

Monto y reglas de secuencia#

  • La cantidad total de captura no puede exceder el monto autorizado, después de cualquier reversión que afecte el saldo disponible.
  • Alcanzar el monto autorizado completo hace que la solicitud sea final; final_capture no es necesario en ese caso.
  • Una captura final fuera de línea por debajo del monto autorizado requiere que la conexión con el procesador admita capturas parciales.
  • Después de que se haya realizado una operación de captura final, DEUNA no acepta otra captura para esa secuencia.
  • DEUNA no impone un límite en el número de transacciones para capturas en modo offline. La cantidad, el umbral, la conexión y las reglas del procesador son los límites efectivos.

Siempre calcule la entrega a partir de los montos confirmados. Una captura en modo offline no es el dinero recolectado del procesador.

Estado y manejo de errores#

EstadoSignificado en un flujo MPCAcción del comerciante
authorizedLos fondos están reservados y no hay capturas parciales pendientes.Envíe las capturas elegibles antes de que expire la autorización.
partial_capturingUna o más cantidades están pendientes o almacenadas en búfer.Mantenga las cantidades pendientes y confirmadas separadas; no trate la cantidad almacenada en búfer como recolectada.
capturingSe está capturando el monto total acumulado.Espere el resultado definitivo.
partial_capturedUn monto total inferior a la autorización fue confirmado por el procesador.Registre el monto confirmado. No cree otra captura si la secuencia se ha finalizado.
capturedSe capturó el monto total autorizado.Registre la finalización de la captura.

Un tiempo de espera o una solicitud asíncrona aceptada no prueban que la captura haya tenido éxito o no. Obtenga la información de pago y procese los webhooks de DEUNA hasta que esté disponible un estado confirmado. Una captura en línea fallida conserva el estado de pago previamente confirmado, mientras que la operación fallida permanece visible en el historial de transacciones.

Para la tabla de transición completa, consulte Flujo de trabajo y estados de pago. Para solicitudes superpuestas, consulte Captura y reembolso simultáneo.

Configure MPC#

Trabaje con su representante técnico de DEUNA para configurar la conexión:

ConfiguraciónEn líneaSin conexión
Estado de la funcionalidadRequeridoRequerido
Modo de operaciónonlineoffline
Fecha límite de capturaNo utilizado por DEUNARequerido: 1–45 días calendario
Capacidad del procesadorCaptura nativa parcial y múltipleSoporte de captura: también se requiere la captura parcial cuando el total final puede ser inferior a la autorización

En el panel de administración, utilice los detalles del pedido para supervisar las solicitudes de captura, el importe acumulado, el importe autorizado restante y el límite de captura guardado, según corresponda. La activación, las credenciales y los límites del procesador pueden variar según el país y la conexión.