Use when user asks to register or update payment status for an existing order and requires confirm flow before mutation.
Registra un evento de pago en un pedido existente (Pedidos) mediante referencia (folio u operation_id_ref). Actualiza estado_pago, agrega traza auditable en notas y requiere confirmacion explicita antes de ejecutar la mutacion.
pagado|pendiente|parcial).operation_id.order.create, order.cancel).order.update).order.lookup, ).order.statusfolio o operation_id_ref (si falta, runtime intenta resolver por lookup textual y pide aclaracion si hay ambiguedad).estado_pago obligatorio: pagado | pendiente | parcial.monto, metodo, notas opcionales.registra pago del pedido folio op-123 estado pagadoaplica pago pedido id op-xyz {"payment":{"estado_pago":"parcial","monto":350,"metodo":"transferencia"}}confirmar | cancelar.record-payment con resultado trazable por operation_id.estado_pago: flujo de aclaracion con el mismo operation_id.folio|operation_id.operation_id: no-op explicito (Pago ya registrado para <folio>. operation_id: <operation_id>).registra|aplica|abona|liquida + pago|abono|estado de pago).estado_pago obligatorio).pending_confirm con idempotency_key=operation_id.confirmar|cancelar.record-payment y persistir executed|failed.estado_pago y anexar evento [PAGO] en notas sin perder historial.estado_pedido=cancelado (source-of-truth de cancelacion).payment_record_*).estado_pago.