Diferencias de monto en Web Checkout

Estado documental: Propuesto. Este documento define el tratamiento de pagos exactos, incompletos, excesivos y ambiguos.

Monto esperado

Cada orden contiene un monto y una moneda.

{
  "amount": "85.50",
  "currency": "PEN"
}

Cuando se utiliza un QR fijo, el comprador puede tener que ingresar el monto manualmente. Por ello pueden producirse diferencias.

Casos principales

Pago exacto
Pago menor
Pago mayor
Varios pagos
Pago parcial
Movimiento ambiguo
Moneda incompatible

Pago exacto

El monto coincide, pero YUPY todavía debe validar destino, fecha, hora, uso previo del movimiento y otras señales de correlación.

Pago menor

Orden: S/ 85.50
Movimiento: S/ 80.00
Diferencia: S/ 5.50

YUPY debe registrar el movimiento y comunicar que existe una diferencia pendiente.

La ventana puede mostrar:

Recibimos un pago por S/ 80.00.
La operación tiene una diferencia pendiente de S/ 5.50.

La empresa define si admite completar el pago, revisarlo manualmente o aplicar otra política.

Solicitud vinculada por diferencia

Cuando la política lo permita, YUPY puede crear una solicitud vinculada a la orden original para completar el monto.

Orden original
    ├── movimiento recibido
    └── solicitud por diferencia

Debe conservar monto esperado, recibido, diferencia, movimientos y estado.

Varios movimientos para completar una orden

Orden: S/ 85.50
Primer movimiento: S/ 80.00
Segundo movimiento: S/ 5.50
Total recibido: S/ 85.50

YUPY puede vincular ambos movimientos cuando la política de la empresa lo permita y exista evidencia suficiente.

Pago mayor

Orden: S/ 85.50
Movimiento: S/ 90.00
Exceso: S/ 4.50

YUPY registra el excedente y comunica a la empresa que existe un caso que puede requerir devolución.

Información para resolver un exceso

YUPY debe poner a disposición:

• transacción original;
• movimiento recibido;
• monto esperado;
• monto recibido;
• exceso;
• medio utilizado;
• fecha y hora;
• referencias disponibles;
• constancia asociada;
• estado del caso.

Alertas y pendientes

Los pagos incompletos, excesivos o ambiguos deben:

• aparecer en una pantalla de pendientes;
• ser informados mediante los canales inmediatos configurados;
• incluirse en reportes periódicos;
• estar disponibles para consulta y exportación.

La periodicidad y los destinatarios se acuerdan con cada empresa.

Pagos parciales

La empresa puede decidir no admitirlos, admitirlos como excepción o acumular varios movimientos.

La política se configura por empresa o caso de uso y no debe inferirse automáticamente.

Operaciones simultáneas del mismo monto

Orden A: S/ 85.50
Orden B: S/ 85.50
Movimiento: S/ 85.50

YUPY no debe elegir arbitrariamente. Debe utilizar las señales disponibles y, cuando no sean suficientes, marcar el caso para revisión.

Constancia y código de transacción

El comprador puede presentar su código de transacción y enviar una captura o constancia para ayudar a resolver una diferencia o ambigüedad.

La evidencia complementa la conciliación, pero no reemplaza por sí sola el movimiento financiero.

Moneda incompatible

Un movimiento en una moneda diferente no debe tratarse únicamente como una diferencia de monto. Debe enviarse a revisión bajo la política de la empresa.

Estados propuestos

movement_detected
reconciliation_pending
amount_difference
partial_received
overpaid
ambiguous
review_required
reconciled

Eventos propuestos

payment.amount_difference
payment.partial_received
payment.overpaid
payment.ambiguous
payment.review_required
payment.reconciled
refund.pending

Criterios de aceptación

1. YUPY diferencia pago exacto, menor y mayor.
2. El movimiento original se conserva.
3. La política de pagos parciales es configurable.
4. Los movimientos adicionales pueden vincularse con auditoría.
5. El excedente se registra y no desaparece.
6. YUPY informa, pero no ejecuta la devolución.
7. Los casos aparecen en pendientes y reportes.
8. El comprador puede presentar código y constancia.
9. Un movimiento no se reutiliza.
10. No se concilia arbitrariamente entre órdenes iguales.