Preautorizaciones

Esta operación permite reservar un monto en la tarjeta del cliente sin realizar el cobro inmediato, ideal para flujos donde se necesita confirmar el cargo en una etapa posterior del proceso comercial

---

Características principales

Retención temporal del saldo

Permite bloquear un monto específico en la tarjeta del cliente sin realizar un cobro inmediato. Esto garantiza que los fondos estén disponibles mientras se completa o confirma la transacción.

Soporte para tokenización

Si el cliente ya tiene un token de tarjeta, la preautorización se realiza directamente en modalidad server to server. Si no se cuenta con un token, el sistema genera una URL de checkout para que el cliente complete la preautorización ingresando su tarjeta.

Control de vencimiento y seguridad

La preautorización mantiene la cantidad bloqueado por un período determinado por el banco emisor (habitualmente entre 7 y 30 días). No se cobra al cliente, solo se reserva.

Reutilizable para múltiples cargos

Una preautorización puede ser utilizada para realizar uno o varios cargos parciales (según el procesador), siempre dentro del período de vigencia y sin exceder el monto retenido.

---

Flujo de uso

1. El comercio solicita una preautorización con o sin tokenId usando la API /preauthorization.

2. Si hay token, la operación se realiza inmediatamente (respuesta sin interacción del cliente).

3. Si no hay token, se retorna una checkoutUrl que el comercio puede enviar al cliente.

4. El cliente completa la preautorización en el entorno seguro del procesador (CECA).

5. El comercio guarda el ID de la preautorización para poder realizar cargos posteriores.

---

Consideraciones

• La preautorización no representa un cobro, solo una reserva de fondos.

• Se registra con estado inicial IN_PROGRESS y debe ser cobrada manualmente mediante la API /preauthorization/authorization.

• Si no se realiza el cobro antes del vencimiento, la reserva se libera automáticamente.

• El identificador preauthorizationId debe conservarse y tratarse como un identificador sensible de la sesión de pago.

Cobro de Preautorización (Authorization)

Permite realizar el cargo efectivo de una preautorización previamente generada. Debe usarse dentro del período de vigencia del bloqueo.

---

Características principales

Cargo total o parcial

Permite al comercio cobrar el monto total o solo una parte del valor previamente autorizado.

Validación del token original

Se utiliza el mismo token, merchantId, terminalId, y userId registrados en la preautorización original para garantizar integridad.

Registro completo de transacción

El sistema guarda los detalles del cargo, incluyendo:

• Referencia bancaria

• Fecha del cobro

• Monto efectivamente cargado

• Monto restante liberado

---

Flujo de uso

1. El comercio invoca la API /preauthorization/authorization con el preauthorizationId y la cantidad a cargar.

2. El sistema valida que la cantidad no exceda el valor autorizado.

3. Se realiza el cargo.

4. El sistema responde con:

   • captured: true

   • captureDate

   • finalAmountCharged

   • remainingAmountUnlocked (si es un cargo parcial)

---

Consideraciones

• Este método solo puede usarse una vez por preautorización si el contrato no permite cargos múltiples.

• Si el monto solicitado para el cobro es mayor al autorizado, el sistema retorna un 400 Bad Request.

• La fecha de cobro (captureDate) se registra como comprobante de la finalización de la operación.

• El cobro se realiza en entorno seguro, con firma digital válida.

• En caso de error del procesador, se retorna un mensaje con el código de error específico.