API Technical Docs

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

Expiración y pagos tardíos

Estado documental: Contrato propuesto. La duración exacta de la observación posterior depende de la configuración y del servicio contratado.

Qué es un pago tardío

Un pago tardío es un ingreso identificado después de que la experiencia de cobro dejó de estar activa.

Puede ocurrir después de:

  • vencer una sesión de Web Checkout;
  • expirar la vigencia operativa;
  • cancelar una orden;
  • cerrar un turno;
  • informar al comprador que la ventana terminó.
Sesión vencida
≠ imposibilidad de recibir dinero

Orden cancelada
≠ desaparición de un ingreso posterior

El vencimiento no elimina la operación financiera

YUPY puede continuar identificando ingresos posteriores asociados con una orden vencida o cancelada.

La documentación no promete un periodo universal. La ventana aplicable se define por configuración y contrato.

Flujo

Orden creada
        ↓
Checkout vence o la orden se cancela
        ↓
Comprador paga después
        ↓
YUPY identifica el ingreso
        ↓
No reactiva automáticamente la venta
        ↓
Genera un caso pendiente
        ↓
Alerta a la empresa

Estado separado

{
  "state": {
    "operational": "expired",
    "financial": "late_detected"
  }
}

Una orden puede estar operativamente vencida y, al mismo tiempo, tener dinero identificado.

Acciones de YUPY

YUPY debe:

  • conservar la relación con la orden original;
  • registrar el resultado financiero;
  • identificar que ocurrió fuera de la ventana;
  • crear un pendiente;
  • alertar a los responsables configurados;
  • mostrarlo en los reportes;
  • entregar la información necesaria para resolverlo.

YUPY no debe:

  • reactivar automáticamente la venta;
  • entregar automáticamente el producto;
  • aceptar comercialmente el pago en nombre de la empresa;
  • devolver automáticamente el dinero.

Decisión de la empresa

aceptar el pago tardío
continuar la venta
reprogramar el servicio
mantener el caso pendiente
rechazar la operación comercial
crear un caso de devolución

Toda decisión debe quedar auditada.

Comunicación al comprador

Detectamos un pago realizado después de la vigencia
de la operación.

La empresa debe revisar el caso.
Conserva tu código de transacción.

YUPY no comunica que el pago fue aceptado comercialmente hasta que la empresa lo determine.

Alertas

La empresa puede configurar alertas para:

  • vendedor;
  • supervisor;
  • responsable del dispositivo;
  • administrador;
  • otra persona autorizada.

Canales posibles:

WhatsApp
correo electrónico
chat operativo
consola
webhook

Webhook relacionado

Este ejemplo reutiliza el evento y el sobre canónico documentados en API y Webhooks.

{
  "event_id": "evt_01J007",
  "event_type": "payment.late_detected",
  "event_version": "1.0",
  "created_at": "2026-07-20T15:10:00-05:00",
  "data": {
    "yupy_transaction_id": "ypt_01JXYZ",
    "external_transaction_id": "ORDER-10482",
    "expected_amount": "85.50",
    "detected_amount": "85.50",
    "currency": "PEN",
    "detected_at": "2026-07-20T15:10:00-05:00",
    "state": {
      "operational": "expired",
      "financial": "late_detected"
    },
    "action_required": "client_review"
  }
}

Pago posterior a una cancelación

cancelled
+ ingreso identificado
→ cancelled_order_with_payment
→ pending case

La cancelación no se elimina ni se transforma silenciosamente.

Reportes

Los pagos tardíos deben aparecer en:

  • reporte de pagos tardíos;
  • bandeja de pendientes;
  • reporte de transacciones;
  • reporte de conciliación;
  • reporte de canceladas con pago;
  • resumen operativo correspondiente;
  • exportaciones programadas cuando estén configuradas.

Criterios de aceptación

  1. La expiración no borra la orden.
  2. La cancelación no oculta ingresos posteriores.
  3. El pago tardío se asocia con la orden original.
  4. No se reactiva automáticamente la venta.
  5. Se crea un pendiente.
  6. Se alerta a la empresa.
  7. La empresa decide la resolución comercial.
  8. Una devolución sigue siendo ejecutada por la empresa.
  9. El caso conserva trazabilidad.
  10. El caso aparece en reportes y auditoría.