x402 / MPP / Tempo

Flujos de pago y trazabilidad del ecosistema.

x402 (micropagos HTTP)

Flujo verificado: 1. El cliente llama al endpoint del catálogo sin token. 2. El gateway responde HTTP 402 + challenge x402 en headers. 3. El cliente paga en USDC (Base) con la clave de idempotencia del challenge. 4. El facilitator verifica el pago on-chain; el gateway entrega el recurso.

Componentes (radhika-payments-go): gate (termina el 402), facilitator (verifica), webhook (concilia), mcp de pagos.

Reglas de idempotencia (obligatorias en toda implementación)

• Misma clave + mismo payload: un único efecto.
• Misma clave + payload distinto: rechazo.
• Worker con fencing obsoleto: escritura rechazada.
• Presupuesto agotado: no se autoriza otro gasto.
• Trabajo terminado sin evidencia: rechazo o reapertura.
• Recompensa duplicada: rechazo.

MPP (metapayments)

• Estado: NOT_RUN en local — el servicio MPP no está desplegado (un puerto que antes se documentó como MPP corresponde en realidad al stack de logs). No anunciar MPP como operativo.

Conciliación

• Caída de PostgreSQL: recuperación y conciliación documentadas como requisito (Postgres es el estado canónico; los JSON son desechables).
• Pérdida de Valkey: integridad transaccional preservada (cola/caché, no estado).
• Timeout externo: consultar estado antes de reintentar.

Tempo (trazas)

• Backend de trazas distribuidas del stack de observabilidad — ver Observabilidad.