Enlace de selección de cantidad

Esta operación permite a los comercios ofrecer al cliente diferentes cantidades predefinidas o permitirle ingresar una cantidad personalizada para realizar su pago.

Características principales

Pago asistido con opción de selección

El enlace de selección de cantidad permite al comercio generar un link único con opción de convertirlo en un QR si el comercio lo desea y que el cliente podrá abrir en su dispositivo para:

• Escoger entre una lista de montos predefinidos configurados por el comercio.

• O, si el comercio lo permite, ingresar manualmente un monto personalizado dentro de los límites establecidos.

Ideal para ventas flexibles, donaciones, recargas o cualquier flujo donde se ofrecen opciones de cantidad al cliente.

---

🕑 Fecha de expiración configurable

• El comercio puede definir una fecha de expiración personalizada para el enlace.

• Si no se especifica, el sistema aplicará una expiración por defecto.

• Esto mejora la seguridad y evita enlaces expuestos por periodos excesivos.

---

Comportamiento dinámico basado en la configuración

• Si se define un monto fijo (amount), el sistema genera un enlace directo para pagar esa cantidad.

• Si no se define amount y se provee una lista de amounts, el cliente podrá seleccionar entre las opciones disponibles.

Esta flexibilidad permite adaptar el enlace al flujo específico de venta o servicio.

---

Transacción segura

Las transacciones iniciadas mediante este tipo de enlace:

• Se asocian a un comercio autenticado mediante mecanismos seguros.

• Se procesan en canales cifrados y cumplen requisitos de protección de datos.

• Permiten trazabilidad completa para efectos de auditoría.

---

Flujo de uso

1. El comercio invoca la API POST /link/amount-selection, enviando un objeto que puede contener:

   • Un amount fijo para pago inmediato.

   • O una lista amounts con montos predefinidos seleccionables.

2. El sistema genera un enlace seguro de pago.

3. El comercio envía el enlace al cliente.

4. El cliente:

   • Si hay múltiples montos disponibles, elige uno en pantalla.

   • O si el enlace es directo a un monto, simplemente paga.

5. El sistema registra la transacción como IN_PROGRESS hasta su pago o expiración.

---

Consideraciones

• El amount y la lista amounts son mutuamente excluyentes: si se define amount, no se debe definir amounts.

• Los montos en amounts deben cumplir las reglas de negocio:

  • Estar dentro de los límites de minAmount y maxAmount si se configuraron.

  • Ser múltiplos de amountMultiple si se define esta propiedad.

• El expirationDate debe ser una fecha futura.

• Los enlaces deben ser tratados como sensibles; no exponer públicamente sin control.