API Technical Docs

Mantente al día con las innovaciones tecnológicas que están transformando el mercado.

“Ya pagué” y evidencia complementaria

Estado documental: Propuesto. Este documento define la acción “Ya pagué”, la evidencia complementaria y el control de verificaciones repetidas.

Concepto

La acción “Ya pagué” registra que el comprador afirma haber realizado el pago y solicita continuar la verificación de esa transacción.

“Ya pagué”
= payment_reported

payment_reported
≠ reconciled

La acción no confirma que el dinero llegó.

Flujo propuesto

Comprador realiza el pago
        ↓
Presiona “Ya pagué”
        ↓
YUPY registra payment_reported
        ↓
YUPY mantiene y refuerza la verificación
        ↓
Conciliación, diferencia o revisión
        ↓
Resultado visible y notificación backend

Registro de la acción

YUPY debe registrar como mínimo:

  • yupy_transaction_id;
  • checkout_session_id;
  • hora del primer reporte;
  • opción de pago presentada cuando esté disponible;
  • canal;
  • intentos posteriores;
  • identificador técnico de la solicitud.

La acción no permite alterar el monto, la moneda, el perfil de cobro ni el estado financiero.

Mensaje al comprador

Después de la acción, la ventana puede mostrar:

Estamos esperando la confirmación del pago.

Aún estamos esperando la confirmación del pago.
La verificación continúa.

Cuando exista evidencia complementaria:

Recibimos tu constancia y estamos verificando la operación.

No debe mostrarse “Pago confirmado” hasta que YUPY complete la conciliación.

Verificación reforzada

Al registrarse “Ya pagué”, YUPY incorpora esa señal al proceso de verificación y mantiene actualizada la experiencia mientras procesa la información financiera disponible.

El proceso puede combinar:

  • datos de la orden;
  • medio y opción presentada;
  • hora de la operación;
  • movimientos disponibles;
  • evidencia complementaria;
  • reglas de correlación configuradas.

Los mecanismos técnicos, frecuencias y proveedores utilizados forman parte de la operación interna de YUPY. La acción ayuda a enfocar la verificación, pero no constituye una confirmación financiera.

Control de acciones repetidas

Cada llamada a fuentes externas puede tener un costo. Por ello, la repetición del botón debe ser idempotente y estar limitada.

Primer clic válido
→ registra payment_reported
→ incorpora la señal al ciclo de verificación

Clics posteriores dentro de la misma ventana operativa
→ actualizan auditoría o experiencia
→ no crean una orden
→ no crean un pago
→ no disparan una consulta externa independiente por cada clic

YUPY puede aplicar:

  • bloqueo temporal del botón;
  • indicador de verificación en curso;
  • ventana de enfriamiento;
  • límite por sesión;
  • protección contra automatización;
  • registro de intentos repetidos.

Evidencia complementaria de conciliación

Cuando el pago todavía no pueda resolverse con las señales disponibles, YUPY debe permitir solicitar una captura o constancia sin importar el medio utilizado.

La evidencia puede incluir:

  • captura de pantalla;
  • constancia de pago;
  • hora aproximada;
  • medio utilizado;
  • referencia visible del comprobante;
  • otra información mínima necesaria para ubicar la operación.

El nombre del comprador no debe considerarse una señal principal, porque quien compra puede no ser el titular de Yape, Plin o la cuenta utilizada.

Canales para recibir la constancia

YUPY utiliza el canal configurado para solicitar y recibir la evidencia.

Puede ser:

  • la propia ventana de Web Checkout;
  • chat de YUPY;
  • WhatsApp;
  • canal de soporte de la empresa;
  • otro canal integrado.

Reprocesamiento de la conciliación

Cuando el comprador indica “Ya pagué, pero mi pago no fue aceptado”, YUPY debe asociar la constancia con la transacción y ampliar o reejecutar el análisis de conciliación.

Comprador reporta el problema
        ↓
YUPY solicita la constancia
        ↓
La evidencia se vincula con la transacción
        ↓
YUPY amplía o reejecuta la conciliación
        ↓
Confirma, mantiene en espera o deriva a revisión

La constancia ayuda a resolver el caso, pero no reemplaza por sí sola la evidencia financiera.

Cuando la operación sigue pendiente

La ventana debe mantener una comunicación neutral:

Estamos esperando la confirmación del pago.
La verificación continúa.

Recibimos tu constancia.
Estamos revisando la operación.

Puede ofrecer esperar, enviar constancia, contactar soporte o presentar el código de transacción.

Operaciones similares

Cuando existan varias órdenes o movimientos compatibles, “Ya pagué” y la constancia se utilizan como señales de apoyo, pero YUPY no debe asignar arbitrariamente el movimiento.

Si la evidencia sigue siendo insuficiente, el caso debe marcarse para revisión.

Ventana vencida

Si el comprador reportó el pago antes del vencimiento, la verificación puede continuar después.

Si la sesión ya venció, el comprador puede usar el canal de atención y su código de transacción para enviar la constancia.

Eventos propuestos

payment.reported
payment.evidence_requested
payment.evidence_received
payment.review_required
payment.reconciled

Los eventos visuales no sustituyen el webhook financiero.

Criterios de aceptación

  1. “Ya pagué” registra una señal y no una confirmación.
  2. La primera hora reportada se conserva.
  3. Los clics repetidos son idempotentes y limitados.
  4. Cada clic no dispara una consulta externa independiente.
  5. Los mensajes al comprador son neutrales.
  6. La captura está disponible para cualquier medio de pago.
  7. YUPY puede recibirla por el canal configurado.
  8. La evidencia se vincula con la transacción.
  9. La conciliación puede ampliarse o reejecutarse.
  10. No se asigna arbitrariamente un movimiento ambiguo.