Captura y reembolso simultáneo
Comprenda cómo se validan y serializan las solicitudes de captura y reembolso superpuestas en los flujos de pago de DEUNA compatibles.
En esta página
DEUNA puede serializar solicitudes de captura o reembolso superpuestas para la misma transacción en los flujos compatibles. La serialización protege el cálculo del saldo acumulado: después de que una solicitud actualiza la transacción, la siguiente solicitud se valida en función del nuevo saldo.
Qué garantiza la serialización#
Para un flujo habilitado para la concurrencia, DEUNA procesa la sección de cambio de saldo de cada solicitud de forma individual para la misma transacción. Esto evita que dos solicitudes superpuestas validen contra el mismo saldo desactualizado.
La serialización no garantiza que todas las solicitudes superpuestas tengan éxito. Después de que la primera solicitud se haya aplicado, una solicitud posterior puede ser rechazada porque:
- El importe excede el saldo restante disponible para captura o reembolso.
- El procesamiento de corte ha finalizado la secuencia MPC o MPR.
- Una solicitud anterior ha finalizado la secuencia de captura o reembolso.
- El estado de la transacción ya no permite la operación.
- El procesador o la conexión no admiten la operación parcial solicitada.
Las solicitudes para diferentes transacciones aún se pueden procesar de forma independiente.
Guía de integración para el comercio minorista#
- Utilice los puntos finales existentes de captura y reembolso; no existe un punto final de concurrencia separado.
- Asigne una identidad única a cada operación comercial prevista. Un reintento del cliente y una segunda operación financiera no son lo mismo.
- No calcule el siguiente importe a partir de un estado almacenado en caché o una única respuesta. Obtenga la última transacción y reconcile su historial de operaciones.
- Trate
partial_capturing,capturing,partial_refundingyrefundingen estados sin resolver. - Procese los webhooks de forma idempotente y almacene los identificadores y los montos de las operaciones, no solo el estado de pago.
- Si hay una concurrencia de solicitudes, maneje una denegación debido al saldo, al límite, a la operación final o a un estado inválido como un resultado de validación autoritativo. No lo intente de nuevo como una nueva operación financiera sin recuperar primero el pago.
Alcance y limitaciones#
Este comportamiento se aplica a los flujos de captura y reembolso admitidos. No convierte las solicitudes de autorización o cancelación en parte de la misma secuencia serializada de operaciones parciales.
Las llamadas al procesador aún pueden ser asíncronas. La serialización protege la actualización del saldo de DEUNA, pero no convierte un tiempo de espera del procesador o una respuesta pendiente en un resultado final inmediato. Espere un estado confirmado antes de completar o comunicarse con el cliente.
Para la agregación de capturas y los límites, consulte MPC: capturas parciales múltiples. Para la agregación de reembolsos y los límites, consulte MPR: Reembolsos parciales múltiples.