MPC - Múltiples capturas parciales
Configure y opere múltiples capturas parciales nativas del procesador o gestionadas por DEUNA, incluyendo las reglas de corte y el comportamiento final de la captura.
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#
| Modo | Cuando se contacta al procesador | Control gestionado por DEUNA | final_capture comportamiento |
|---|---|---|---|
| En línea | Cada solicitud de captura se envía inmediatamente al procesador. | No | Ignorada 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ón | Las 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#
- El pago llega
authorized. - Cada captura no final se valida contra el importe autorizado restante y se almacena sin llamar al procesador.
- Mientras que una o más cantidades de captura están en cola, el pago es
partial_capturing. - 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.
- DEUNA envía la cantidad acumulada neta de captura al procesador como una única operación de captura.
- 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 enpartial_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:
{
"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_captureno 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#
| Estado | Significado en un flujo MPC | Acción del comerciante |
|---|---|---|
authorized | Los fondos están reservados y no hay capturas parciales pendientes. | Envíe las capturas elegibles antes de que expire la autorización. |
partial_capturing | Una 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. |
capturing | Se está capturando el monto total acumulado. | Espere el resultado definitivo. |
partial_captured | Un 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. |
captured | Se 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ón | En línea | Sin conexión |
|---|---|---|
| Estado de la funcionalidad | Requerido | Requerido |
| Modo de operación | online | offline |
| Fecha límite de captura | No utilizado por DEUNA | Requerido: 1–45 días calendario |
| Capacidad del procesador | Captura nativa parcial y múltiple | Soporte 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.