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: Implementado y verificado en Producción.

Qué hace “Ya pagué”

En modo normal, Ya pagué registra en POO la declaración canónica PAYMENT_DECLARED y luego continúa consultando el estado real de la Payment Order. La declaración es no terminal: no marca pagado, no establece confirmed_at y no sustituye la confirmación financiera.

No confirma un pago. No modifica directamente la Payment Order. No genera por sí solo un estado pagado.

Flujo productivo

Usuario presiona “Ya pagué”
→ Web Checkout registra PAYMENT_DECLARED en POO
→ payment_declared_at conserva el milestone de declaración
→ Browser/SDK continúa consultando el estado canónico
→ solo POO refleja pagado | cancelado | timeout como resultado terminal

Si todavía no existe confirmación, la UI mantiene un mensaje neutral y el polling normal continúa.

Lo que NO hace

  • no crea payment_reported;
  • no cambia status a pagado;
  • no adjunta evidencia;
  • no inicia OCR;
  • no dispara una conciliación externa independiente por cada clic;
  • no altera monto, moneda, instrumento ni timeout;
  • no crea otra Payment Order.

Cualquier futuro flujo de evidencia o payment_reported deberá documentarse como contrato separado cuando exista y esté certificado.

Relación con polling

polling automático
       +
clic manual
       ↓
misma fuente canónica de status

Estados terminales

Si el recheck devuelve un estado terminal, Browser actualiza la UI y comunica el resultado al SDK:

pagado
cancelado
timeout
failed

Regla de seguridad financiera

click “Ya pagué”
≠
status = pagado

La confirmación proviene de YUPY/POO y los mecanismos financieros autorizados.