Cómo funciona

sequenceDiagram
    autonumber
    participant C as Comprador
    participant T as Tienda Magento
    participant P as Plataforma
    participant A as App del teléfono
    C->>T: Confirma el pedido (método Yape)
    T->>P: Publica el pedido abierto (importe único)
    C->>C: Paga por Yape el importe exacto
    A->>A: Detecta la notificación de Yape
    A->>P: Envía el evento (firmado, idempotente)
    P->>P: Concilia evento ↔ pedido
    T->>P: Consulta coincidencias (saliente)
    T->>T: Aplica según su política (anotar / aprobar)

Los pasos

1. El comprador elige «Pago con Yape» en el checkout. El pedido recibe un importe único (se ajusta de 0 a 99 céntimos) para distinguirlo de otros.
2. El conector publica el pedido abierto a la plataforma, sin datos personales del comprador.
3. El comprador paga por Yape a tu número.
4. La app detecta la notificación y la guarda localmente antes de enviarla. Solo marca «enviado» cuando la plataforma confirma.
5. La plataforma concilia: busca el pedido abierto del mismo comercio, entorno y monto dentro del plazo (15 min por defecto).
6. Magento recoge la coincidencia y actúa según la política que elegiste: nada (sombra), anotar, aprobar con un clic o aprobar solo.

Principios que conviene recordar

• El teléfono detecta y transporta; la plataforma concilia; Magento decide.
• Nada se pierde ni se duplica: cada evento tiene un event_id y repetir un envío es inocuo.
• Todo se separa por cliente y por entorno (test / live). Un evento de pruebas nunca toca datos de producción.
• Latido: teléfono y conector avisan que siguen vivos; si dejan de hacerlo, hay alerta.